{"openapi":"3.1.0","info":{"title":"Dashio Developer API","version":"2026.11.29","description":"Workspace automation for approved Dashio products. Each token is scoped to one Space and independently granted operations. Requests spend shared minute credits, and selected operation groups also share hourly quotas."},"servers":[{"url":"https://app.dashio.net","description":"Dashio App"}],"tags":[{"name":"Space"},{"name":"Developer Domains"},{"name":"Developer Compliance"},{"name":"Developer Marketing"},{"name":"Developer Marketing Signatures"},{"name":"Developer Marketing Billing"},{"name":"Developer Marketing Microsoft 365"},{"name":"Developer Compliance Workspace"},{"name":"Developer Framework Assessments"},{"name":"Developer Compliance Records"},{"name":"Developer Compliance Evidence"},{"name":"Developer Compliance Exports"},{"name":"Developer Compliance Training"},{"name":"Developer Compliance Trust"},{"name":"Developer Compliance Trust Center"},{"name":"Developer Compliance Workflows"}],"paths":{"/api/v1/space":{"get":{"tags":["Space"],"parameters":[],"responses":{"200":{"description":"The active Space bound to the token.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["space"],"properties":{"space":{"type":"object","additionalProperties":false,"required":["id","name","slug"],"properties":{"id":{"type":"string","format":"uuid","description":"Stable Space identifier."},"name":{"type":"string","description":"Current Space display name."},"slug":{"type":"string","description":"Current URL slug. A Space administrator can rename it."}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Query parameters were supplied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the required grant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The token Space is no longer available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space exceeded its request quota. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Space information is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperSpace","summary":"Get the token’s Space","description":"Returns the ID, display name and URL slug of the Space bound to the developer token. The request accepts no Space selector or other query parameters.","security":[{"developerToken":[]}],"x-required-scopes":["space:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/space/members":{"get":{"tags":["Space"],"parameters":[{"in":"query","name":"limit","description":"Maximum memberships to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"in":"query","name":"cursor","description":"The nextCursor from the previous page.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"A page of current Space memberships.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["members","pagination"],"properties":{"members":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["id","role"],"properties":{"id":{"type":"string","format":"uuid","description":"Stable membership identifier."},"role":{"type":"string","enum":["owner","admin","member"]}}}},"pagination":{"$ref":"#/components/schemas/DeveloperDomainPagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid pagination or unsupported query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the space:members:read grant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Space membership data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperSpaceMembers","summary":"List Space member roles","description":"Returns membership IDs and roles in the active Space bound to the token. Use the nextCursor unchanged to continue the list.","security":[{"developerToken":[]}],"x-required-scopes":["space:members:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/space/domain-verifications":{"get":{"tags":["Space"],"parameters":[{"in":"query","name":"limit","description":"Maximum verification entries to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"in":"query","name":"cursor","description":"The nextCursor from the previous page.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"A page of Space domain verification entries.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["domainVerifications","pagination"],"properties":{"domainVerifications":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["id","domain","verifiedAt","expiresAt"],"properties":{"id":{"type":"string","format":"uuid","description":"Stable verification identifier."},"domain":{"type":"string","maxLength":253,"description":"Domain selected for verification."},"verifiedAt":{"type":["string","null"],"format":"date-time","description":"Last successful verification, when available."},"expiresAt":{"type":["string","null"],"format":"date-time","description":"Recorded verification expiry, when available."}}}},"pagination":{"$ref":"#/components/schemas/DeveloperDomainPagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid pagination or unsupported query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the space:domains:read grant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Space verification data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperSpaceDomainVerifications","summary":"List Space domain verifications","description":"Returns verification and expiry timestamps for domain verification entries in the token’s active Space. Pending and expired entries may appear. Use the nextCursor unchanged to continue the list, including past any skipped invalid historical entries.","security":[{"developerToken":[]}],"x-required-scopes":["space:domains:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/domains":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"query","name":"limit","description":"Maximum number of domains to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"in":"query","name":"cursor","description":"The nextCursor from the previous page.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Domain inventory page.","content":{"application/json":{"schema":{"type":"object","required":["domains","pagination"],"properties":{"domains":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperDomain"}},"pagination":{"$ref":"#/components/schemas/DeveloperDomainPagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid pagination or unsupported query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing, expired, revoked, or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or domain inventory is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDomains","summary":"List domains","description":"Lists existing domains in the token’s Space in stable ID order. Use the returned nextCursor unchanged to continue. Terminated and transferred-out domains are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["domains:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/domains/{domain}":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string"}}],"responses":{"200":{"description":"Domain inventory item.","content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"$ref":"#/components/schemas/DeveloperDomain"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The domain name is invalid or an unexpected query parameter was supplied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing, expired, revoked, or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or domain inventory is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDomain","summary":"Get a domain","description":"Returns the recorded registration status and dates for a domain belonging to the token’s Space.","security":[{"developerToken":[]}],"x-required-scopes":["domains:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/domains/{domain}/nameservers":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}}],"responses":{"200":{"description":"The stored nameserver set. An empty list means no nameservers are recorded.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["nameservers"],"properties":{"nameservers":{"type":"array","maxItems":32,"items":{"type":"object","additionalProperties":false,"required":["name","ipv4","ipv6"],"properties":{"name":{"type":"string","format":"hostname","maxLength":253,"description":"Lowercase ASCII nameserver hostname without the root dot."},"ipv4":{"type":["string","null"],"format":"ipv4","description":"Stored public IPv4 glue address, when available."},"ipv6":{"type":["string","null"],"format":"ipv6","description":"Stored public IPv6 glue address, when available."}}}}}},"example":{"nameservers":[{"name":"ns1.example.com","ipv4":null,"ipv6":null},{"name":"ns2.example.com","ipv4":null,"ipv6":null}]}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The domain name is invalid or an unexpected query parameter was supplied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:nameservers:read or the domain is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"Domain settings become available when registration is active.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or stored domain settings are temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperDomainNameservers","summary":"Get domain nameservers","description":"Returns the delegation recorded for an active domain in the token’s Space. Nameservers are ordered by their saved sequence. Glue addresses are null when absent or unsuitable for public delegation.","security":[{"developerToken":[]}],"x-required-scopes":["domains:nameservers:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"put":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this exact request. Use the same key and body when retrying.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{16,128}$"}}],"responses":{"200":{"description":"Confirmed delegation, or the previous result of an identical request.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"X-Mutation-Request-Id":{"description":"Original mutation identifier for support.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when returning an existing result.","schema":{"type":"string","const":"true"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["nameservers"],"properties":{"nameservers":{"type":"array","minItems":2,"maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["name","ipv4","ipv6"],"properties":{"name":{"type":"string","format":"hostname","maxLength":253},"ipv4":{"type":["string","null"],"format":"ipv4"},"ipv6":{"type":["string","null"],"format":"ipv6"}}}}}},"example":{"nameservers":[{"name":"ns1.example.net","ipv4":null,"ipv6":null},{"name":"ns2.example.net","ipv4":null,"ipv6":null}]}}}},"400":{"description":"Invalid domain, nameserver set, JSON, idempotency key, or query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:nameservers:write, the issuer’s access changed, or the domain is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"DNSSEC is enabled or unconfirmed, another domain change is in progress, or the key conflicts or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds the request limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"An active registrar-linked domain is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"502":{"description":"The change may have reached the registrar. Contact support using X-Mutation-Request-Id before trying a new change.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"X-Mutation-Request-Id":{"description":"Original mutation identifier for support.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"Registrar or domain settings are temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"replaceDeveloperDomainNameservers","summary":"Replace custom domain nameservers","description":"Replaces the complete custom delegation for an active registrar-linked domain in the token’s Space. Use two to ten distinct lowercase hostnames. Supply public glue only for nameservers within the domain being delegated. Disable DNSSEC before changing delegation. Select managed Dashio nameserver sets in the Portal. A successful result confirms the registrar accepted the set and Dashio saved it.","security":[{"developerToken":[]}],"x-required-scopes":["domains:nameservers:write"],"requestBody":{"required":true,"description":"The complete custom nameserver set. The JSON request is limited to 8,192 bytes.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["nameservers"],"properties":{"nameservers":{"type":"array","minItems":2,"maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","format":"hostname","maxLength":253,"description":"Lowercase fully qualified hostname without a trailing dot."},"ipv4":{"type":["string","null"],"format":"ipv4","description":"Public IPv4 glue for a nameserver within the domain."},"ipv6":{"type":["string","null"],"format":"ipv6","description":"Public IPv6 glue for a nameserver within the domain."}}}}}},"example":{"nameservers":[{"name":"ns1.example.net"},{"name":"ns2.example.net"}]}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/domains/{domain}/dnssec":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}}],"responses":{"200":{"description":"Stored DNSSEC flags and any saved public DNSKEYs.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["dnssec"],"properties":{"dnssec":{"type":"object","additionalProperties":false,"required":["enabled","autoRenew","keys"],"properties":{"enabled":{"type":"boolean","description":"Whether DNSSEC is enabled in the saved configuration. Defaults to false when unset."},"autoRenew":{"type":"boolean","description":"Saved DNSSEC auto-renew preference. Defaults to true when unset."},"keys":{"type":"array","maxItems":32,"items":{"type":"object","additionalProperties":false,"required":["flags","protocol","algorithm","publicKey"],"properties":{"flags":{"type":"integer","minimum":0,"maximum":65535,"description":"DNSKEY flags bit field."},"protocol":{"type":"integer","const":3,"description":"DNSKEY protocol number."},"algorithm":{"type":"integer","minimum":0,"maximum":255,"description":"DNSKEY algorithm number."},"publicKey":{"type":"string","minLength":2,"maxLength":4096,"pattern":"^[A-Za-z0-9+/]+={0,2}$","description":"Base64-encoded public key. Padding may be omitted."}}}}}}}},"example":{"dnssec":{"enabled":false,"autoRenew":true,"keys":[]}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The domain name is invalid or an unexpected query parameter was supplied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:dnssec:read or the domain is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"Domain settings become available when registration is active.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or stored domain settings are temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperDomainDnssec","summary":"Get domain DNSSEC settings","description":"Returns the saved DNSSEC configuration for an active domain in the token’s Space. The key list can be empty until settings are synchronized. This operation does not query or change the registry.","security":[{"developerToken":[]}],"x-required-scopes":["domains:dnssec:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/domains/{domain}/forwarding":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}}],"responses":{"200":{"description":"The active redirect settings or null when forwarding is disabled.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["forwarding"],"properties":{"forwarding":{"type":["object","null"],"additionalProperties":false,"required":["targetUrl","redirectType","preservePath","preserveQueryString"],"properties":{"targetUrl":{"type":"string","format":"uri","maxLength":8192,"description":"HTTP or HTTPS destination with any embedded credentials removed."},"redirectType":{"type":"integer","enum":[301,302],"description":"Redirect status code. 301 is permanent and 302 is temporary."},"preservePath":{"type":"boolean","description":"Whether the redirect preserves the original request path."},"preserveQueryString":{"type":"boolean","description":"Whether the redirect preserves the original query string."}}}}},"example":{"forwarding":{"targetUrl":"https://www.example.com/","redirectType":301,"preservePath":true,"preserveQueryString":true}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The domain name is invalid or an unexpected query parameter was supplied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:forwarding:read or the domain is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"Domain settings become available when registration is active.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or stored domain settings are temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperDomainForwarding","summary":"Get domain forwarding settings","description":"Returns active URL forwarding for a domain in the token’s Space. A domain without an active rule returns null. Any username or password embedded in a legacy destination is removed from the response.","security":[{"developerToken":[]}],"x-required-scopes":["domains:forwarding:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/domains/{domain}/records":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string"}},{"in":"query","name":"limit","description":"Maximum number of DNS records to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"in":"query","name":"cursor","description":"The nextCursor from the previous page.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"DNS records page.","content":{"application/json":{"schema":{"type":"object","required":["records","pagination"],"properties":{"records":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperDnsRecord"}},"pagination":{"$ref":"#/components/schemas/DeveloperDomainPagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid domain, pagination, or query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing, expired, revoked, or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks dns:read or the domain is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The domain lacks one supported active DNS zone.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or DNS data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDomainRecords","summary":"List DNS records","description":"Returns stored DNS records for the single supported active zone of a domain belonging to the token’s Space. Use the returned nextCursor unchanged to continue.","security":[{"developerToken":[]}],"x-required-scopes":["dns:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique, case-sensitive key scoped to the Space. Retry with the same key and payload.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}}],"responses":{"201":{"description":"DNS record created.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"X-Mutation-Request-Id":{"description":"Correlation ID of the original mutation reservation.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this result comes from the original completed request.","schema":{"type":"boolean"}}},"content":{"application/json":{"schema":{"type":"object","required":["record"],"additionalProperties":false,"properties":{"record":{"$ref":"#/components/schemas/DeveloperDnsRecord"}}}}}},"400":{"description":"Invalid domain, record, idempotency key, request body or query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperDnsRecordValidationError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing, expired, revoked or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks dns:records:write, access has changed or DNS management is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The operation, domain or record is unavailable in the token Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The zone is unavailable, the key conflicts or expired, another change is in progress, or the record conflicts with existing DNS data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request exceeded the supported body limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json for the record body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"502":{"description":"The registrar outcome is uncertain. Retry only the original key or contact support with X-Mutation-Request-Id.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"X-Mutation-Request-Id":{"description":"Use this ID to request reconciliation.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"Domain data or the mutation service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createDeveloperDomainRecord","summary":"Create DNS record","description":"Creates one supported DNS record in the active primary zone. A token bound to the domain Space and an Idempotency-Key are required. Retry the same key and payload to retrieve a completed result for 24 hours. An uncertain registrar outcome pauses Portal and Developer API writes for the domain until reviewed.","security":[{"developerToken":[]}],"x-required-scopes":["dns:records:write"],"requestBody":{"required":true,"description":"The complete record. The UTF-8 JSON body is limited to 8192 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperDnsRecordMutationRequest"},"example":{"record":{"type":"A","name":"www","value":"203.0.113.10","ttl":3600}}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/domains/{domain}/records/{recordId}":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","maxLength":253}},{"in":"path","name":"recordId","required":true,"description":"Dashio DNS record ID.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The requested stored DNS record.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperDnsRecord"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid domain, record UUID or query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the DNS read grant or the domain is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain or record is unavailable in the token Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The domain lacks one supported active DNS zone.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or DNS data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperDomainRecord","summary":"Read a DNS record","description":"Returns one stored DNS record by its Dashio ID. Use the ID returned by List DNS records or Create a DNS record. The record must belong to the domain’s current active zone.","security":[{"developerToken":[]}],"x-required-scopes":["dns:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}},{"in":"path","name":"recordId","required":true,"description":"Stable record UUID from the active zone list.","schema":{"type":"string","format":"uuid"}},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique, case-sensitive key scoped to the Space. Retry with the same key and payload.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"DNS record replaced.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"X-Mutation-Request-Id":{"description":"Correlation ID of the original mutation reservation.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this result comes from the original completed request.","schema":{"type":"boolean"}}},"content":{"application/json":{"schema":{"type":"object","required":["record"],"additionalProperties":false,"properties":{"record":{"$ref":"#/components/schemas/DeveloperDnsRecord"}}}}}},"400":{"description":"Invalid domain, record, idempotency key, request body or query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperDnsRecordValidationError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing, expired, revoked or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks dns:records:write, access has changed or DNS management is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The operation, domain or record is unavailable in the token Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The zone is unavailable, the key conflicts or expired, another change is in progress, or the record conflicts with existing DNS data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request exceeded the supported body limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json for the record body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"The selected record type can be listed but cannot be changed through the Developer API.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"502":{"description":"The registrar outcome is uncertain. Retry only the original key or contact support with X-Mutation-Request-Id.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"X-Mutation-Request-Id":{"description":"Use this ID to request reconciliation.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"Domain data or the mutation service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateDeveloperDomainRecord","summary":"Replace DNS record","description":"Replaces every public field of the selected record while retaining its UUID. A token bound to the domain Space and an Idempotency-Key are required. Retry the same key and payload to retrieve a completed result for 24 hours. An uncertain registrar outcome pauses Portal and Developer API writes for the domain until reviewed.","security":[{"developerToken":[]}],"x-required-scopes":["dns:records:write"],"requestBody":{"required":true,"description":"The complete record. The UTF-8 JSON body is limited to 8192 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperDnsRecordMutationRequest"},"example":{"record":{"type":"A","name":"www","value":"203.0.113.10","ttl":3600}}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}},"delete":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}},{"in":"path","name":"recordId","required":true,"description":"Stable record UUID from the active zone list.","schema":{"type":"string","format":"uuid"}},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique, case-sensitive key scoped to the Space. Retry with the same key and payload.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}}],"responses":{"204":{"description":"DNS record deleted.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"X-Mutation-Request-Id":{"description":"Correlation ID of the original mutation reservation.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this result comes from the original completed request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid domain, record, idempotency key, request body or query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing, expired, revoked or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks dns:records:write, access has changed or DNS management is restricted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The operation, domain or record is unavailable in the token Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The zone is unavailable, the key conflicts or expired, another change is in progress, or the record conflicts with existing DNS data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request exceeded the supported body limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"The selected record type can be listed but cannot be changed through the Developer API.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"502":{"description":"The registrar outcome is uncertain. Retry only the original key or contact support with X-Mutation-Request-Id.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"X-Mutation-Request-Id":{"description":"Use this ID to request reconciliation.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"Domain data or the mutation service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteDeveloperDomainRecord","summary":"Delete DNS record","description":"Deletes one supported record from the active primary zone. Send no request body. A token bound to the domain Space and an Idempotency-Key are required. Retry the same key and payload to retrieve a completed result for 24 hours. An uncertain registrar outcome pauses Portal and Developer API writes for the domain until reviewed.","security":[{"developerToken":[]}],"x-required-scopes":["dns:records:write"],"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/domains/{domain}/security-audits":{"post":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string"},"example":"example.com"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Use 16 to 128 ASCII letters, digits, underscores or hyphens. Reuse the same key when retrying this domain audit.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"example":"61d9263e-143b-4407-90fd-e3b54df67c96"}],"responses":{"200":{"description":"A terminal audit receipt reused during the cooldown or replayed from the same key.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Location":{"$ref":"#/components/headers/DeveloperDomainAuditLocation"},"Idempotency-Replayed":{"$ref":"#/components/headers/DeveloperDomainAuditReplay"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperDomainAuditRequestReceipt"}}}},"202":{"description":"Audit queued or already running. Poll the Location URL for current status.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Location":{"$ref":"#/components/headers/DeveloperDomainAuditLocation"},"Idempotency-Replayed":{"$ref":"#/components/headers/DeveloperDomainAuditReplay"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperDomainAuditRequestReceipt"}}}},"400":{"description":"Invalid domain, JSON body, or missing or malformed idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the required permission, current access changed, or audits are restricted for this domain.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain or an earlier requested audit is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"This idempotency key is already associated with another domain.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds 256 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request body must use application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"A Developer request, daily audit job, or daily receipt key limit was reached. Edge traffic limits can also return 429.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds until the applicable budget resets.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"The API or audit queue is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"requestDomainSecurityAudit","summary":"Request a domain security audit","description":"Queues an audit for an existing domain in the token’s Space or reuses the current run during the domain cooldown. Send an empty JSON object and reuse the same key for retries. The beta allows 10 new audit jobs and 100 distinct receipt keys per Space per UTC day. Receipts are available for seven days. The Location header points to the current audit status.","security":[{"developerToken":[]}],"x-required-scopes":["domains:security:write"],"requestBody":{"required":true,"description":"An empty JSON object, up to 256 bytes. The URL determines the registered domain.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false},"example":{}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/domains/{domain}/security-audits/{auditId}":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string"},"example":"example.com"},{"in":"path","name":"auditId","required":true,"description":"Audit ID returned by the request operation.","schema":{"type":"string","format":"uuid"},"example":"5714db63-7bba-4bf4-a46f-2f92e155d69a"}],"responses":{"200":{"description":"Current audit status.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["audit"],"properties":{"audit":{"$ref":"#/components/schemas/DeveloperDomainAudit"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid domain or audit ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the required permission or current Space access changed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The audit is unavailable for this domain and Space, or the Developer receipt expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or audit state is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDomainSecurityAudit","summary":"Get domain security audit status","description":"Polls the current state of a domain audit identified by a Developer API receipt from the token’s Space. This operation returns queue status and timestamps. Find the report and evidence in the Dashio portal.","security":[{"developerToken":[]}],"x-required-scopes":["domains:security:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/domains/{domain}/registration":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}}],"responses":{"200":{"description":"Stored registration settings. Null fields have no recorded value.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["registration"],"properties":{"registration":{"type":"object","additionalProperties":false,"required":["expiresAt","registryExpiresAt","autoRenew","transferLock"],"properties":{"expiresAt":{"type":["string","null"],"format":"date-time","description":"Expiration date recorded by Dashio."},"registryExpiresAt":{"type":["string","null"],"format":"date-time","description":"Last known expiration date at the domain registry."},"autoRenew":{"type":["boolean","null"],"description":"Saved automatic renewal preference."},"transferLock":{"type":"object","additionalProperties":false,"required":["enabled","supported"],"properties":{"enabled":{"type":["boolean","null"],"description":"Whether a transfer lock is recorded as enabled."},"supported":{"type":["boolean","null"],"description":"Whether the registrar reports support for transfer locking."}}}}}}},"example":{"registration":{"expiresAt":"2027-11-12T00:00:00Z","registryExpiresAt":"2027-11-12T00:00:00Z","autoRenew":true,"transferLock":{"enabled":true,"supported":true}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid domain or unsupported query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:registration:read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Domain lifecycle data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperDomainRegistration","summary":"Read domain registration settings","description":"Returns recorded expiration dates, automatic renewal preference, and transfer lock settings for a domain in the token’s Space. Registry data reflects the most recent saved synchronization.","security":[{"developerToken":[]}],"x-required-scopes":["domains:registration:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/domains/{domain}/transfer":{"get":{"tags":["Developer Domains"],"parameters":[{"in":"path","name":"domain","required":true,"description":"Registered domain in lowercase ASCII or punycode.","schema":{"type":"string","minLength":3,"maxLength":253}}],"responses":{"200":{"description":"The current recorded transfer state.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["transfer"],"properties":{"transfer":{"type":"object","additionalProperties":false,"required":["state","transferredOutAt"],"properties":{"state":{"type":"string","enum":["none","pending-inbound","completed-outbound"],"description":"Pending incoming transfer, completed departure, or no transfer recorded for the current registration."},"transferredOutAt":{"type":["string","null"],"format":"date-time","description":"Recorded departure time, when available for a completed outbound transfer."}}}}},"example":{"transfer":{"state":"pending-inbound","transferredOutAt":null}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid domain or unsupported query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks domains:transfer:read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The domain is unavailable in the token’s Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Domain lifecycle data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperDomainTransfer","summary":"Read domain transfer status","description":"Returns the recorded state of an incoming transfer or a completed departure for the token’s Space. An unlocked domain does not imply a transfer has started.","security":[{"developerToken":[]}],"x-required-scopes":["domains:transfer:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/controls":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous control page."}],"responses":{"200":{"description":"Saved controls and the current workspace revision.","content":{"application/json":{"schema":{"type":"object","required":["records","revision","pagination"],"properties":{"records":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceControl"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance controls are unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds until the request can be retried.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceControls","summary":"List Compliance controls","description":"Lists saved control summaries in the token’s Space. Requires an active Compliance entitlement. Legacy records with unsupported IDs are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:controls:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Records"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive within the time limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the record ID is in use, or a record limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds 65,536 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request body must be JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceControl","summary":"Create a Compliance control","description":"Creates a saved control at the supplied workspace revision and returns a change receipt. Requires an active Compliance entitlement. A successful create advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:controls:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","recordId","title","description","ownerContactId","frameworks","status","dueDate"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"recordId":{"type":"string","minLength":2,"maxLength":30,"pattern":"^[A-Z][A-Z0-9-]{1,29}$"},"title":{"type":"string","minLength":1,"maxLength":512},"description":{"type":"string","minLength":1,"maxLength":8000},"ownerContactId":{"type":"string","minLength":1,"maxLength":180},"frameworks":{"type":"array","minItems":1,"maxItems":6,"uniqueItems":true,"items":{"type":"string","enum":["ISO 27001","SOC 2","NIS2","EU AI Act","BSI C5","VDA ISA"]}},"status":{"type":"string","enum":["On track","In review","Needs attention"]},"dueDate":{"type":"string","format":"date"}}},"example":{"revision":4,"recordId":"AC-42","title":"Quarterly access review","description":"Review privileged access each quarter.","ownerContactId":"contact-audit-owner","frameworks":["ISO 27001"],"status":"On track","dueDate":"2027-03-31"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/controls/{controlId}":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"controlId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Stable saved control ID."}],"responses":{"200":{"description":"Saved control summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceControl"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The control ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The control was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceControl","summary":"Get a Compliance control","description":"Reads a saved control summary in the token’s Space. Requires an active Compliance entitlement. Use the ID from the control list and URL-encode it as one path segment.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:controls:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"controlId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."},{"in":"query","name":"revision","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Current saved Compliance workspace revision."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the record is linked, or the workspace revision limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceControl","summary":"Delete a Compliance control","description":"Deletes an unlinked control at the supplied workspace revision. References must be removed before the record can be deleted. A successful deletion advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:controls:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"controlId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive within the time limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale or the workspace revision limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds 65,536 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request body must be JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceControl","summary":"Update a Compliance control","description":"Updates the supplied control fields at the current saved workspace revision. Other record data is preserved. An unchanged request returns changed=false. A saved change advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:controls:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"anyOf":[{"type":"object","required":["title"]},{"type":"object","required":["description"]},{"type":"object","required":["status"]},{"type":"object","required":["dueDate"]}],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","minLength":1,"maxLength":512},"description":{"type":"string","minLength":1,"maxLength":8000},"status":{"type":"string","enum":["On track","In review","Needs attention"]},"dueDate":{"type":"string","format":"date"}}},"example":{"revision":4,"status":"In review"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/risks":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous risk page."}],"responses":{"200":{"description":"Saved risks and the current workspace revision.","content":{"application/json":{"schema":{"type":"object","required":["records","revision","pagination"],"properties":{"records":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceRisk"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance risks are unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds until the request can be retried.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceRisks","summary":"List Compliance risks","description":"Lists saved risk summaries in the token’s Space. Requires an active Compliance entitlement. Legacy records with unsupported IDs are omitted. The returned revision is used for risk edits and remains consistent across pages.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:risks:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Records"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive within the time limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the record ID is in use, or a record limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds 65,536 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request body must be JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceRisk","summary":"Create a Compliance risk","description":"Creates a saved risk at the supplied workspace revision and returns a change receipt. Requires an active Compliance entitlement. Use a nonzero ID matching R- followed by three to twelve digits. A successful create advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:risks:manage"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","recordId","title","description","ownerContactId","category","likelihood","impact","residualScore","status","treatment"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"recordId":{"type":"string","minLength":5,"maxLength":14,"pattern":"^R-(?!0+$)[0-9]{3,12}$"},"title":{"type":"string","minLength":1,"maxLength":512},"description":{"type":"string","minLength":1,"maxLength":8000},"ownerContactId":{"type":"string","minLength":1,"maxLength":180},"category":{"type":"string","enum":["Operational","Business continuity","Identity & access","AI governance","Infrastructure","Third-party","People & awareness"]},"likelihood":{"type":"integer","minimum":1,"maximum":5},"impact":{"type":"integer","minimum":1,"maximum":5},"residualScore":{"type":"integer","minimum":0,"maximum":100,"description":"Must not exceed four times the likelihood multiplied by the impact."},"status":{"type":"string","enum":["Open","In progress","In review","Monitoring","Resolved"]},"treatment":{"type":"string","enum":["Mitigate","Transfer","Accept","Avoid"]},"dueDate":{"type":"string","format":"date"}}},"example":{"revision":4,"recordId":"R-042","title":"Service continuity risk","description":"Review the restore procedure.","ownerContactId":"contact-audit-owner","category":"Business continuity","likelihood":2,"impact":3,"residualScore":12,"status":"Open","treatment":"Mitigate"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/risks/{riskId}":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"riskId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Stable saved risk ID."}],"responses":{"200":{"description":"Saved risk summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceRisk"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The risk ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The risk was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceRisk","summary":"Get a Compliance risk","description":"Reads a saved risk summary in the token’s Space. Requires an active Compliance entitlement. Use the ID from the risk list and URL-encode it as one path segment. The returned revision can be used for a risk update.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:risks:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"riskId","required":true,"schema":{"type":"string"},"description":"Stable saved risk ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Risk change receipt and its resulting workspace revision.","content":{"application/json":{"schema":{"type":"object","required":["riskId","revision","changed"],"additionalProperties":false,"properties":{"riskId":{"type":"string","description":"Stable saved risk ID."},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changed":{"type":"boolean","description":"Whether the requested status or treatment changed."}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The risk ID, revision or change is invalid, or an unexpected query parameter was supplied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the write scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The risk was not found in the token’s Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive within the time limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale or the workspace revision limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds 4,096 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request body must be JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds until the request can be retried.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}}},"503":{"description":"The change could not be confirmed. Read the current risk before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceRisk","summary":"Update a Compliance risk","description":"Sets the status or treatment of one saved risk in the token’s Space. Use the revision from a current risk page. A successful change advances the workspace revision and records a Space audit event. An unchanged request at the current revision returns changed=false.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:risks:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["revision"],"additionalProperties":false,"anyOf":[{"type":"object","required":["status"]},{"type":"object","required":["treatment"]}],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["Open","In progress","In review","Monitoring","Resolved"]},"treatment":{"type":"string","enum":["Mitigate","Transfer","Accept","Avoid"]}}},"example":{"revision":1,"status":"In review"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"riskId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."},{"in":"query","name":"revision","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Current saved Compliance workspace revision."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the record is linked, or the workspace revision limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceRisk","summary":"Delete a Compliance risk","description":"Deletes an unlinked risk at the supplied workspace revision. References must be removed before the record can be deleted. A successful deletion advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:risks:manage"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1800},"description":"Opaque nextCursor from a previous supplier page."}],"responses":{"200":{"description":"Saved suppliers and the current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceSupplier"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance suppliers are unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceSuppliers","summary":"List Compliance suppliers","description":"Lists saved suppliers in the token’s Space. Requires an active Compliance entitlement. Includes the supplier assessment summary. Contact details, documents, schedules and notes are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:suppliers:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-policies":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1800},"description":"Opaque nextCursor from a previous training policy page."}],"responses":{"200":{"description":"Saved training policies and the current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceTrainingPolicy"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance training policies are unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceTrainingPolicies","summary":"List Compliance training policies","description":"Lists saved training policies in the token’s Space. Requires an active Compliance entitlement. Includes policy identifiers and titles. Policy content and acknowledgment data are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-policies:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Training"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive within the time limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the record ID is in use, or a record limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds 65,536 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request body must be JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceTrainingPolicy","summary":"Create a Compliance training policy","description":"Creates a saved training policy at the supplied workspace revision and returns a change receipt. Requires an active Compliance entitlement. A successful create advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-policies:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","recordId","title","description"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"recordId":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{0,79}$"},"title":{"type":"string","minLength":1,"maxLength":512},"description":{"type":"string","minLength":1,"maxLength":8000}}},"example":{"revision":4,"recordId":"policy-access-reviews","title":"Access review policy","description":"Review privileged access each quarter."}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/signatures":{"get":{"tags":["Developer Marketing"],"parameters":[{"name":"limit","in":"query","description":"Maximum signatures to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","description":"Use nextCursor from the previous page.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"A page of signature metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["signatures","pagination"],"properties":{"signatures":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperMarketingSignatureSummary"}},"pagination":{"type":"object","additionalProperties":false,"required":["limit","nextCursor"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"nextCursor":{"type":["string","null"],"format":"uuid","description":"Null when there are no further pages."}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid limit, cursor or unsupported query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token missing, invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Current Marketing entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks marketing:signatures:read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Marketing operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"Token or Space rate limit exceeded. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or signature inventory is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listMarketingSignatures","summary":"List Marketing signatures","description":"Returns signature names, slugs, revisions and publication timestamps for the token’s Space. Requests require a current Marketing entitlement. Use the returned cursor to continue a page.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Marketing Signatures"],"parameters":[],"responses":{"201":{"description":"The newly created draft ID and revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMarketingSignatureLifecycleReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createMarketingSignature","summary":"Create a signature draft","description":"Creates an unpublished signature draft in the token Space. The name and slug are customer-selected. The active plan limits the number of signatures. If an interrupted request already created the slug, the next attempt reports a conflict.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:manage"],"requestBody":{"required":true,"description":"Choose either starterId with optional changes or a complete version 1 draftConfig. A starter uses the signature name as its company name unless changes.companyName is supplied. The JSON limit is 2 MiB.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","slug"],"oneOf":[{"type":"object","required":["draftConfig"],"not":{"anyOf":[{"required":["starterId"]},{"required":["changes"]}]}},{"type":"object","required":["starterId"],"not":{"required":["draftConfig"]}}],"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"description":"Visible signature name. Surrounding whitespace is removed. Control and bidirectional formatting characters are rejected."},"slug":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","description":"Unique URL slug within the Space."},"draftConfig":{"$ref":"#/components/schemas/DeveloperMarketingSignatureConfigInput"},"starterId":{"type":"string","enum":["essential","contact-first","campaign-ready","brand-side","editorial","corporate","atelier"],"description":"Uses the same empty starting design as the Portal. Contains no gallery examples or employee data."},"changes":{"$ref":"#/components/schemas/DeveloperMarketingSignatureChanges"}}},"example":{"name":"Support team","slug":"support-team","draftConfig":{"version":1,"locales":[{"code":"en","label":"English"}],"defaultLocale":"en","company":{"name":"Example Company","website":"https://example.com","closingPhrase":{"en":"Kind regards"},"legalText":{},"socialLinks":[]},"locations":[],"fields":[{"id":"name","type":"text","label":{"en":"Name"},"placeholder":{"en":"Alex Morgan"},"required":true,"showLabel":false,"options":[]},{"id":"email","type":"email","label":{"en":"Email"},"placeholder":{"en":"alex.morgan@example.com"},"required":true,"showLabel":false,"options":[]}],"logos":[],"banners":[],"branding":{"primaryColor":"#2563eb","showDashioBranding":false}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/signatures/{signatureId}":{"get":{"tags":["Developer Marketing"],"parameters":[{"name":"signatureId","in":"path","required":true,"description":"Stable signature ID from the inventory.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The signature’s editable draft and current revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMarketingSignatureDraftResponse"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid signature ID or unexpected query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token missing, invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Current Marketing entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks marketing:signatures:read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The signature was not found in the token’s Space or Marketing is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"Token or Space rate limit exceeded. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or signature data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getMarketingSignature","summary":"Read a Marketing signature draft","description":"Returns the editable company draft and its current revision for one signature in the token’s Space. Requests require a current Marketing entitlement.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"put":{"tags":["Developer Marketing"],"parameters":[{"name":"signatureId","in":"path","required":true,"description":"Stable signature ID from the inventory.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Confirmation of the committed draft replacement.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["signatureId","revision","updatedAt"],"properties":{"signatureId":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":1,"description":"Revision assigned to the committed draft."},"updatedAt":{"type":"string","format":"date-time"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid ID, unexpected query parameter, or invalid draft request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token missing, invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Current Marketing entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks marketing:signatures:write or no longer has current Space write access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The signature was not found in the token’s Space or Marketing is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The signature revision changed. Read the current draft before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON request exceeds 2 MiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"Token or Space rate limit exceeded. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or signature data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateMarketingSignature","summary":"Replace a Marketing signature draft","description":"Saves a complete draft at the supplied revision. The signature name, employee page address and publication state are preserved. Returns a receipt with the committed revision. After an interrupted response, use a read-scoped token to check the current draft before retrying.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:write"],"requestBody":{"required":true,"description":"Supply the complete version 1 configuration and the revision returned by the draft read. The JSON request is limited to 2 MiB.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","draftConfig"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483646,"description":"Revision the replacement expects."},"draftConfig":{"$ref":"#/components/schemas/DeveloperMarketingSignatureConfigInput"}}},"example":{"revision":3,"draftConfig":{"version":1,"locales":[{"code":"en","label":"English"}],"defaultLocale":"en","company":{"name":"Example Company","website":"https://example.com","closingPhrase":{"en":"Kind regards"},"legalText":{},"socialLinks":[]},"locations":[],"fields":[{"id":"name","type":"text","label":{"en":"Name"},"placeholder":{"en":"Alex Morgan"},"required":true,"showLabel":false,"options":[]},{"id":"email","type":"email","label":{"en":"Email"},"placeholder":{"en":"alex.morgan@example.com"},"required":true,"showLabel":false,"options":[]}],"logos":[],"banners":[],"branding":{"primaryColor":"#2563eb","showDashioBranding":false}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The committed metadata revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMarketingSignatureLifecycleReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateMarketingSignatureDetails","summary":"Update a signature name and slug","description":"Replaces the display name and URL slug at the expected revision. A token changing the URL slug of a published signature also needs the publication scope.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:manage"],"x-conditional-scopes":{"marketing:signatures:publish":"Required when changing a published signature’s URL slug."},"requestBody":{"required":true,"description":"Supply the expected revision, new display name and slug.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","name","slug"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483646},"name":{"type":"string","minLength":1,"maxLength":120,"description":"Visible signature name. Surrounding whitespace is removed. Control and bidirectional formatting characters are rejected."},"slug":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","description":"Unique URL slug within the Space."}}},"example":{"revision":2,"name":"Support team","slug":"support-team"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}},{"name":"revision","in":"query","required":true,"description":"Current signature revision.","schema":{"type":"integer","minimum":1,"maximum":2147483646}}],"responses":{"204":{"description":"The signature was deleted.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"This operation does not accept a request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteMarketingSignature","summary":"Delete a signature","description":"Deletes the signature and ends public access after its current revision has been verified. Remove its connected custom domains before deleting it.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:manage"],"x-rate-limit":{"requestCredits":10,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"file_transfer","windowSeconds":3600,"tokenRequests":24,"spaceRequests":60}}}},"/api/v1/marketing/signatures/{signatureId}/draft":{"patch":{"tags":["Developer Marketing Signatures"],"parameters":[{"name":"signatureId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Committed draft edit receipt.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["signatureId","revision","updatedAt"],"properties":{"signatureId":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":1},"updatedAt":{"type":"string","format":"date-time"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid ID, unsupported changes or invalid resulting signature.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Marketing entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Current Space access and signature write scope required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Signature not found in the token Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"Request body deadline exceeded.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"Revision changed. Read the latest revision before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"JSON exceeds 16 KiB.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"Token or Space rate limit exceeded. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Signature data unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"patchMarketingSignatureDraft","summary":"Edit selected signature draft settings","description":"Applies bounded company, typography, existing office and contact-field changes to the current draft at the supplied revision. Omitted fields, custom blocks and images are retained. The canonical configuration validator and atomic draft writer check the resulting draft. Changes affect the draft only.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:write"],"requestBody":{"required":true,"description":"JSON is limited to 16 KiB. Obtain revision and existing location/field IDs from the signature draft.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483646},"changes":{"$ref":"#/components/schemas/DeveloperMarketingSignatureChanges"}}},"example":{"revision":3,"changes":{"companyName":"Example Company","primaryColor":"#0f766e"}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/brand-kit":{"get":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"Authorized Brand Kit configuration and usage.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["profiles","assets"],"properties":{"profiles":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperBrandProfile"}},"assets":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperBrandAsset"}},"usage":{"type":"object","additionalProperties":false,"required":["usedBytes","fileCount","maxTotalBytes"],"properties":{"usedBytes":{"type":"integer","minimum":0},"fileCount":{"type":"integer","minimum":0},"maxTotalBytes":{"type":"integer","minimum":1}},"description":"Storage use includes reservations that still occupy the Space allowance."}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unknown query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the Brand Kit read permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Marketing is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The Brand Kit exceeds the supported response size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Brand Kit data is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMarketingBrandKit","summary":"Read the Marketing Brand Kit","description":"Returns brand profiles for the token’s Space. Ready logo metadata and storage usage require the Brand Asset read permission after portal licensing is enabled. Image bytes and storage paths are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:brand:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Marketing"],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Use one unique key per request. Reuse it with the same input for seven days to recover a committed receipt.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"The committed Brand Kit profile receipt.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Idempotency-Replayed":{"description":"Set to true when this response reuses a committed receipt.","schema":{"type":"string","const":"true"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["recordId","replayed"],"properties":{"recordId":{"type":"string","format":"uuid"},"replayed":{"type":"boolean"}}}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The idempotency key conflicts, logos still belong to the profile, or the record is changing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the supported size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request content type is unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"mutateDeveloperMarketingBrandKit","summary":"Save, default or delete a Brand Kit profile","description":"Creates a profile when saveProfile has no ID. Replaces profile fields when it has an ID. Use setDefault to switch defaults and deleteProfile after its logos have been removed. A successful write returns the record ID only.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:brand:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","oneOf":[{"type":"object","additionalProperties":false,"required":["action","profile"],"properties":{"action":{"type":"string","const":"saveProfile"},"id":{"type":["string","null"],"format":"uuid"},"profile":{"type":"object","additionalProperties":false,"required":["name","description","guidelines","isDefault","colors","typography","additionalColors"],"properties":{"name":{"type":"string","minLength":1,"maxLength":60},"description":{"type":"string","maxLength":600},"guidelines":{"type":"string","maxLength":4000},"isDefault":{"type":"boolean"},"colors":{"type":"object","additionalProperties":false,"required":["primary","secondary","accent"],"properties":{"primary":{"type":"string","pattern":"^#?(?:[a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"secondary":{"type":"string","pattern":"^#?(?:[a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"},"accent":{"type":"string","pattern":"^#?(?:[a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"}}},"typography":{"type":"object","additionalProperties":false,"required":["headingFamily","bodyFamily","notes","headingWeight","bodyWeight"],"properties":{"headingFamily":{"type":"string","minLength":1,"maxLength":60},"bodyFamily":{"type":"string","minLength":1,"maxLength":60},"notes":{"type":"string","maxLength":500},"headingWeight":{"type":"integer","enum":[100,200,300,400,500,600,700,800,900]},"bodyWeight":{"type":"integer","enum":[100,200,300,400,500,600,700,800,900]}}},"additionalColors":{"type":"array","maxItems":12,"items":{"type":"object","additionalProperties":false,"required":["id","name","hex"],"properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","minLength":1,"maxLength":40},"hex":{"type":"string","pattern":"^#?(?:[a-fA-F0-9]{3}|[a-fA-F0-9]{6})$"}}}}}}}},{"type":"object","additionalProperties":false,"required":["action","id"],"properties":{"action":{"type":"string","const":"setDefault"},"id":{"type":"string","format":"uuid"}}},{"type":"object","additionalProperties":false,"required":["action","id"],"properties":{"action":{"type":"string","const":"deleteProfile"},"id":{"type":"string","format":"uuid"}}}]},"example":{"action":"saveProfile","profile":{"name":"Primary Brand","description":"Core brand for customer communications.","guidelines":"Use the primary blue on light backgrounds.","isDefault":true,"colors":{"primary":"#2563eb","secondary":"#171717","accent":"#10b981"},"typography":{"headingFamily":"Inter","bodyFamily":"Inter","headingWeight":700,"bodyWeight":400,"notes":""},"additionalColors":[]}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/utm":{"get":{"tags":["Developer Marketing"],"parameters":[{"in":"query","name":"collection","description":"Select the record collection.","schema":{"type":"string","enum":["campaigns","links","presets"],"default":"campaigns"}},{"in":"query","name":"limit","description":"Maximum records per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"in":"query","name":"cursor","description":"nextCursor from the same Space, collection and filters. Unfiltered lists use UUID cursors.","schema":{"type":"string","maxLength":800}},{"in":"query","name":"search","description":"Literal case-insensitive substring of name or link label.","schema":{"type":"string","minLength":1,"maxLength":120}},{"in":"query","name":"status","description":"Campaigns only.","schema":{"type":"string","enum":["draft","active","archived"]}},{"in":"query","name":"campaignId","description":"Links only; return links owned by this campaign in the token Space.","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"updatedFrom","description":"Campaigns and links updated on or after this UTC calendar date.","schema":{"type":"string","format":"date"}},{"in":"query","name":"updatedBefore","description":"Campaigns and links updated before this UTC calendar date.","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"One page of Space-owned records and the saved naming policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperUtmPage"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid collection, page controls, or unknown query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the UTM read permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Marketing is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Marketing or its records are temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMarketingUtmWorkspace","summary":"List saved Marketing UTM records","description":"Lists one collection in the token’s Space in stable record ID order. Custom presets exclude built-in portal presets. Search is a literal case-insensitive substring of campaign or preset names or link labels. Filter campaigns by status, links by campaignId, and both by update date. Pass nextCursor unchanged with the same filters. Each page includes the current saved naming policy.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:utm:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Marketing"],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Use 16 to 128 ASCII letters, digits, underscores or hyphens. Generate one key per intended change and reuse it for retries.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"example":"61d9263e-143b-4407-90fd-e3b54df67c96"}],"responses":{"200":{"description":"A confirmed mutation receipt. A replay returns the previously affected record without repeating the change.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Idempotency-Replayed":{"description":"Present as true when returning a stored receipt.","schema":{"type":"string","const":"true"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["action","recordId","replayed"],"properties":{"action":{"type":"string","enum":["campaign.create","campaign.update","campaign.duplicate","campaign.delete","link.create","link.update","link.delete","preset.create","preset.delete","settings.update"]},"recordId":{"type":["string","null"],"format":"uuid","description":"Affected record ID, or null for a naming policy change."},"replayed":{"type":"boolean"}}}}}},"400":{"description":"Invalid action, URL, query, payload, or idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"UTM write permission, current Space access, or a record allowance is missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Marketing or the selected record is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"A key was reused for a different request, or a related record or naming policy changed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 64 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget, or the UTM receipt limit, is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The UTM mutation could not be confirmed. Retry with the same key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"mutateDeveloperMarketingUtmWorkspace","summary":"Change saved Marketing UTM records","description":"Creates, updates, duplicates or deletes campaigns, manages saved links and custom presets, or updates naming rules for the token’s Space. Campaign deletion removes its saved links and duplication copies them. Space audit and mutation commit together. Reuse the original key and action body when retrying. Receipts remain available for seven days, with up to 1000 active receipts per Space.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:utm:write"],"requestBody":{"required":true,"description":"One UTM action and its required inputs, up to 64 KiB of JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperUtmMutation"},"example":{"action":"campaign.create","input":{"name":"Product launch","description":"Spring release","status":"draft","defaults":{"source":"newsletter","medium":"email","campaign":"spring_launch"}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/utm/preview":{"post":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"Generated URL, applied values and names of overwritten UTM parameters.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url","appliedParameters","overriddenKeys"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"appliedParameters":{"$ref":"#/components/schemas/DeveloperUtmPartialParameters"},"overriddenKeys":{"type":"array","items":{"type":"string","enum":["source","medium","campaign","term","content"]},"maxItems":5}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid URL, query, parameters, or resulting URL length.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the UTM preview permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Marketing is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 8 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The saved naming policy is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"previewDeveloperMarketingUtmUrl","summary":"Preview a Marketing UTM URL","description":"Applies the Space’s saved naming rules and preserves unrelated query parameters and the URL fragment. No link is saved and the destination is never fetched.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:utm:preview"],"requestBody":{"required":true,"description":"JSON up to 8 KiB. Supply the original destination and UTM parameters.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["destinationUrl","parameters"],"properties":{"destinationUrl":{"type":"string","format":"uri","maxLength":2048,"description":"Absolute HTTP or HTTPS URL without embedded credentials."},"parameters":{"$ref":"#/components/schemas/DeveloperUtmRequiredParameters"}}},"example":{"destinationUrl":"https://example.com/product?ref=launch#details","parameters":{"source":"Newsletter","medium":"Email","campaign":"Spring Launch","term":"","content":""}}}}},"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/subscription":{"get":{"tags":["Developer Marketing Billing"],"parameters":[],"responses":{"200":{"description":"The recorded Signatures subscription for the token Space.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["subscription"],"properties":{"subscription":{"type":["object","null"],"additionalProperties":false,"required":["planId","status","currentPeriodEnd","cancelAtPeriodEnd"],"properties":{"planId":{"type":["string","null"],"description":"Dashio plan identifier, or null if the plan is unresolved."},"status":{"type":"string","enum":["incomplete","incomplete_expired","trialing","active","past_due","canceled","unpaid","paused"],"description":"Most recent verified subscription state."},"currentPeriodEnd":{"type":["string","null"],"format":"date-time","description":"End of the current billing period when known."},"cancelAtPeriodEnd":{"type":"boolean","description":"Whether the current subscription is set to end with its billing period."}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the subscription read grant or its issuer lost Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Subscription state is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMarketingSubscription","summary":"Read the Marketing subscription","description":"Returns the persisted Signatures plan, payment state, current period end and cancellation setting for the token Space. A null subscription means Dashio has no recorded subscription. Product allowances are available from the Marketing entitlement operation.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:subscription:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/subscription/scheduled-change":{"get":{"tags":["Developer Marketing Billing"],"parameters":[],"responses":{"200":{"description":"The current scheduled change and pending payment indicator.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["scheduledChange","paymentPending"],"properties":{"scheduledChange":{"type":["object","null"],"additionalProperties":false,"required":["planId","planName","effectiveAt"],"properties":{"planId":{"type":"string","description":"Dashio identifier of the scheduled plan."},"planName":{"type":"string","description":"Customer-facing name of the scheduled plan."},"effectiveAt":{"type":"string","format":"date-time","description":"When the next plan phase takes effect."}}},"paymentPending":{"type":"boolean","description":"Whether the billing panel has a recoverable plan-change payment."}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the subscription read grant or its issuer lost Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The current subscription requires a billing ownership or configuration review.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The billing provider or subscription state is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMarketingScheduledPlanChange","summary":"Read the next scheduled Marketing plan change","description":"Reads the next Dashio-managed Signatures plan change for the token Space and indicates when a plan change needs payment. A null change means there is no next scheduled Dashio change. Open the Marketing billing panel to review or confirm payment.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:subscription:read"],"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/signatures/{signatureId}/publish":{"post":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The new publication revision and timestamp.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMarketingSignatureLifecycleReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"publishMarketingSignature","summary":"Publish a signature draft","description":"Publishes the saved draft at the current revision. The normal signature quota applies. The employee-facing snapshot changes only after the transaction commits.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:publish"],"requestBody":{"required":true,"description":"Supply the revision of the saved draft to publish.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483646}}},"example":{"revision":3}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/signatures/{signatureId}/unpublish":{"post":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The new revision with a null publication timestamp.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMarketingSignatureLifecycleReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"unpublishMarketingSignature","summary":"Unpublish a signature","description":"Removes the employee-facing snapshot and preserves the draft. The expected revision prevents a stale request from undoing another administrator’s publication.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signatures:publish"],"requestBody":{"required":true,"description":"Supply the current signature revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483646}}},"example":{"revision":4}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/signatures/{signatureId}/custom-domains":{"get":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Custom domains and current Space allowance.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["configured","limit","used","domains"],"properties":{"configured":{"type":"boolean"},"limit":{"type":"integer","minimum":0},"used":{"type":"integer","minimum":0},"domains":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperMarketingSignatureDomain"}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listMarketingSignatureDomains","summary":"List a signature’s custom domains","description":"Lists hostnames connected to the signature and their customer-facing DNS instructions. Quota usage includes reservations across the token Space.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signature-domains:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"The reserved custom domain and its DNS instructions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMarketingSignatureDomain"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"connectMarketingSignatureDomain","summary":"Connect a custom domain to a signature","description":"Reserves a plan allowance and provisions the requested customer subdomain. The response includes the DNS records to configure and the current verification state.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signature-domains:write"],"requestBody":{"required":true,"description":"Provide a fully qualified customer subdomain.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["hostname"],"properties":{"hostname":{"type":"string","minLength":5,"maxLength":253,"description":"Public customer subdomain. Hostnames are normalized to lowercase."}}},"example":{"hostname":"signatures.example.com"}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/signatures/{signatureId}/custom-domains/{domainId}/verify":{"post":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}},{"in":"path","name":"domainId","required":true,"description":"Stable custom-domain UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Current domain and TLS verification state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMarketingSignatureDomain"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"This operation does not accept a request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"verifyMarketingSignatureDomain","summary":"Refresh custom-domain verification","description":"Checks the current routing and TLS state for this domain. If the provider is still verifying it, the response remains pending.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signature-domains:write"],"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/signatures/{signatureId}/custom-domains/{domainId}":{"delete":{"tags":["Developer Marketing Signatures"],"parameters":[{"in":"path","name":"signatureId","required":true,"description":"Stable signature UUID.","schema":{"type":"string","format":"uuid"}},{"in":"path","name":"domainId","required":true,"description":"Stable custom-domain UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"The custom domain was removed.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"This operation does not accept a request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteMarketingSignatureDomain","summary":"Remove a signature custom domain","description":"Disables employee routing before releasing the domain allowance. Removal remains available after cancellation. An interrupted provider removal can be retried against the same domain ID.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:signature-domains:write"],"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"Setup availability and safe connection state.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["available","enabled","syncEnabled","entitlement","reason","manifestUrl","connection"],"properties":{"available":{"type":"boolean"},"enabled":{"type":"boolean"},"syncEnabled":{"type":"boolean"},"entitlement":{"type":"string","enum":["enterprise","none"]},"reason":{"type":["string","null"],"enum":["integration_disabled","subscription_required",null]},"manifestUrl":{"type":["string","null"],"format":"uri"},"connection":{"type":["object","null"],"additionalProperties":false,"required":["tenantId","status","revision","directoryConsentAt","runtimeConsentReportedAt","runtimeVerifiedAt","lastSyncAt","syncReady","syncPending","publishedAt","hasPublishedAssignments"],"properties":{"tenantId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending","connected","revoked"]},"revision":{"type":"integer","minimum":0,"maximum":2147483646},"directoryConsentAt":{"type":["string","null"],"format":"date-time"},"runtimeConsentReportedAt":{"type":["string","null"],"format":"date-time"},"runtimeVerifiedAt":{"type":["string","null"],"format":"date-time"},"lastSyncAt":{"type":["string","null"],"format":"date-time"},"syncReady":{"type":"boolean"},"syncPending":{"type":"boolean"},"publishedAt":{"type":["string","null"],"format":"date-time"},"hasPublishedAssignments":{"type":"boolean","description":"Published enrollment and an enabled assignment are present. Evaluate recipient matches through Preview."}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMicrosoft365Status","summary":"Get Microsoft 365 setup status","description":"Returns setup availability, the connected tenant identifier and directory status. Browser-based Microsoft administrator consent and Outlook installation are separate.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/microsoft-365/templates":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"Signature template selectors.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["templates"],"properties":{"templates":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name","published","locations","locales","fields","logos","banners","contentOrder"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"published":{"type":"boolean"},"locations":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"locales":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","label"],"properties":{"code":{"type":"string"},"label":{"type":"string"}}}},"fields":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","type","label","required","options"],"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["text","email","tel","url","select"]},"label":{"type":"object","additionalProperties":{"type":"string"}},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["value","label"],"properties":{"value":{"type":"string"},"label":{"type":"object","additionalProperties":{"type":"string"}}}}},"showLabel":{"type":"boolean"},"placeholder":{"type":"object","additionalProperties":{"type":"string"}}}}},"logos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label"],"properties":{"id":{"type":"string"},"label":{"type":"string"}}}},"banners":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label"],"properties":{"id":{"type":"string"},"label":{"type":"string"}}}},"contentOrder":{"type":"array","items":{"type":"string","description":"Matches the pattern ^(?:(?:field|custom):.+|company|address|country|website|socialLinks|logo|banner|legal)$."}}}},"maxItems":100}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperMicrosoft365Templates","summary":"List Microsoft 365 signature templates","description":"Lists same-Space generator metadata and valid assignment selectors. Embedded image bodies and entire drafts are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/microsoft-365/stats":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"Completed-snapshot counts or a reason the counts are unavailable.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["syncedEmployees","enrolledEmployees","lastSyncAt","reason"],"properties":{"syncedEmployees":{"type":["integer","null"],"minimum":0},"enrolledEmployees":{"type":["integer","null"],"minimum":0},"lastSyncAt":{"type":["string","null"],"format":"date-time"},"reason":{"type":["string","null"],"enum":["subscription_required","integration_disabled","tenant_not_connected","sync_required","sync_in_progress","directory_stale","count_limit","invalid_policy","revision_conflict",null]}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMicrosoft365Stats","summary":"Get Microsoft 365 directory counts","description":"Counts synced members and published-policy enrollment from the latest completed directory snapshot. Counts can be null while the snapshot is stale or changing.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365:read"],"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365/users":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[{"in":"query","name":"ids","description":"Up to 200 unique comma-separated directory GUIDs. Omit page and search for ID lookup.","schema":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":200},"style":"form","explode":false},{"in":"query","name":"page","description":"Zero-based page of up to 50 results.","schema":{"type":"integer","minimum":0,"maximum":20000,"default":0}},{"in":"query","name":"search","description":"Case-insensitive search text. Directory filter punctuation is rejected.","schema":{"type":"string","description":"Maximum length is 120 characters.","maxLength":120}}],"responses":{"200":{"description":"A page of up to 50 users or up to 200 requested users.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["users","hasMore"],"properties":{"users":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","displayName","mail","department","officeLocation","enabled","userType","excluded","overrides","revision"],"properties":{"id":{"type":"string","format":"uuid"},"displayName":{"type":"string"},"mail":{"type":"string","description":"Directory mail value, which may be empty."},"department":{"type":"string"},"officeLocation":{"type":"string"},"enabled":{"type":"boolean"},"userType":{"type":"string"},"excluded":{"type":"boolean"},"overrides":{"type":"object","additionalProperties":{"type":"string","description":"Maximum length is 500 characters."},"description":"Keys are field IDs of up to 64 letters, digits, underscores, or hyphens, beginning with a letter or digit. Reserved JavaScript property names are excluded. Maximum of 64 entries."},"revision":{"type":"integer","minimum":0,"maximum":2147483646}}},"maxItems":200},"hasMore":{"type":"boolean","description":"Whether another search page is available. Always false for explicit ID lookups."}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperMicrosoft365Users","summary":"List Microsoft 365 directory users","description":"Reads a bounded page or an explicit set of users in the connected tenant. Returns only the signature administration projection and saved overrides.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-directory:read"],"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365/groups":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[{"in":"query","name":"ids","description":"Up to 200 unique comma-separated directory GUIDs. Omit page and search for ID lookup.","schema":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":200},"style":"form","explode":false},{"in":"query","name":"page","description":"Zero-based page of up to 50 results.","schema":{"type":"integer","minimum":0,"maximum":20000,"default":0}},{"in":"query","name":"search","description":"Case-insensitive search text. Directory filter punctuation is rejected.","schema":{"type":"string","description":"Maximum length is 120 characters.","maxLength":120}}],"responses":{"200":{"description":"A page of up to 50 groups or up to 200 requested groups.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["groups","hasMore"],"properties":{"groups":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","displayName"],"properties":{"id":{"type":"string","format":"uuid"},"displayName":{"type":"string"}}},"maxItems":200},"hasMore":{"type":"boolean","description":"Whether another search page is available. Always false for explicit ID lookups."}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperMicrosoft365Groups","summary":"List Microsoft 365 directory groups","description":"Reads a bounded page or an explicit set of groups in the connected tenant. Group memberships and Graph permissions are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-directory:read"],"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365/policy":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"The current editable and published policies.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","draft","published"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":2147483646},"draft":{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPolicyDocument"},"published":{"type":["object","null"],"anyOf":[{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPolicyDocument"},{"type":"null"}]}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMicrosoft365Policy","summary":"Get the Microsoft 365 signature policy","description":"Returns the current draft, separately published policy and expected revision.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-policy:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"put":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"The committed draft revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483647}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"saveDeveloperMicrosoft365Policy","summary":"Save a Microsoft 365 policy draft","description":"Replaces the full draft at its expected revision. The current published rules remain available to Outlook.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-policy:write"],"requestBody":{"required":true,"description":"Provide the current connection revision and a full version 1 policy. The JSON limit is 256 KiB.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","policy"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":2147483646},"policy":{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPolicyDocument"}}},"example":{"revision":1,"policy":{"version":1,"enrollment":{"allUsers":false,"userIds":[],"groupIds":[]},"excludedUserIds":[],"excludedGroupIds":[],"rules":[]}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/microsoft-365/policy/publish":{"post":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"The committed publication revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483647}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"publishDeveloperMicrosoft365Policy","summary":"Publish a Microsoft 365 signature policy","description":"Validates the full policy and publishes it at the expected connection revision. Enabled assignments must reference currently published templates in the same Space.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-policy:publish"],"requestBody":{"required":true,"description":"Provide the current connection revision and a full version 1 policy. The JSON limit is 256 KiB.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","policy"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":2147483646},"policy":{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPolicyDocument"}}},"example":{"revision":1,"policy":{"version":1,"enrollment":{"allUsers":false,"userIds":[],"groupIds":[]},"excludedUserIds":[],"excludedGroupIds":[],"rules":[]}}}}},"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365/overrides":{"put":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"The committed override revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":2147483647}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"saveDeveloperMicrosoft365Override","summary":"Save a directory signature override","description":"Updates bounded signature fields or enrollment exclusion for one current directory user. A first override uses revision zero. Microsoft directory attributes are unaffected.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-overrides:write"],"requestBody":{"required":true,"description":"Supply the employee ID, allowed signature fields, exclusion and current override revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["userId","fields","excluded","revision"],"properties":{"userId":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":0,"maximum":2147483646},"fields":{"type":"object","additionalProperties":{"type":"string","description":"Maximum length is 500 characters."},"description":"Keys are field IDs of up to 64 letters, digits, underscores, or hyphens, beginning with a letter or digit. Reserved JavaScript property names are excluded. Maximum of 64 entries."},"excluded":{"type":"boolean"}}},"example":{"userId":"cce3b64d-b22a-46be-8ef1-317f1a74b0e9","fields":{"jobTitle":"Support Lead"},"excluded":false,"revision":0}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/microsoft-365/sender-grants":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[{"in":"query","name":"page","description":"Zero-based page of up to 50 results.","schema":{"type":"integer","minimum":0,"maximum":20000,"default":0}}],"responses":{"200":{"description":"One page of current sender grants.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["grants","hasMore"],"properties":{"grants":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["actorId","targetId","approvedAt"],"properties":{"actorId":{"type":"string","format":"uuid"},"targetId":{"type":"string","format":"uuid"},"approvedAt":{"type":"string","format":"date-time"}}}},"hasMore":{"type":"boolean"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperMicrosoft365SenderGrants","summary":"List signature-profile access grants","description":"Lists current Dashio permissions for one directory user to resolve another user’s signature profile. Exchange mailbox and send permissions are managed separately.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-sender-grants:read"],"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}},"put":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"The requested grant state was saved.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["saved"],"properties":{"saved":{"type":"boolean","const":true}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"saveDeveloperMicrosoft365SenderGrant","summary":"Grant or revoke signature-profile access","description":"Updates a Dashio signature-profile grant between distinct users in the current directory. Exchange mailbox and send permissions are managed separately.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-sender-grants:write"],"requestBody":{"required":true,"description":"Set remove to false to grant access or true to revoke access.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["actorId","targetId","remove"],"properties":{"actorId":{"type":"string","format":"uuid"},"targetId":{"type":"string","format":"uuid"},"remove":{"type":"boolean"}}},"example":{"actorId":"ac93cdb0-bf96-4a93-a194-01a15271f968","targetId":"cce3b64d-b22a-46be-8ef1-317f1a74b0e9","remove":false}}}},"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365/preview":{"post":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"One apply or skip decision and any rendered signature preview.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","ruleName","issues","preview"],"properties":{"evaluatedAt":{"type":"string","format":"date-time"},"matchingPolicyIds":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":100},"result":{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPreviewResolution"},"ruleName":{"type":["string","null"]},"issues":{"type":"array","items":{"type":"string"}},"preview":{"type":["object","null"],"additionalProperties":false,"required":["html","text"],"properties":{"html":{"type":"string"},"text":{"type":"string"}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"previewDeveloperMicrosoft365Signature","summary":"Preview a Microsoft 365 signature","description":"Uses the employee resolver to preview one authorized sender and compose type. The response can include rendered HTML, text and the reason an assignment was skipped. Each connection has 30 previews per minute shared with the Portal.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365:preview"],"requestBody":{"required":true,"description":"Select a current directory user and sender address.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["userId","senderAddress","composeType"],"properties":{"userId":{"type":"string","format":"uuid"},"senderAddress":{"type":"string","description":"Maximum length is 254 characters.","format":"email","maxLength":254},"composeType":{"type":"string","enum":["newMail","reply","forward"]},"draft":{"type":"boolean","default":false,"description":"Set true to preview the saved draft policy. Omit to preview the published policy."},"previewAt":{"type":["string","null"],"description":"Optional UTC test time. Null or omission uses the current server time.","format":"date-time"}}},"example":{"userId":"cce3b64d-b22a-46be-8ef1-317f1a74b0e9","senderAddress":"alex.morgan@example.com","composeType":"newMail","draft":true}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"rendering","windowSeconds":3600,"tokenRequests":30,"spaceRequests":80}}}},"/api/v1/marketing/microsoft-365/audit":{"get":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"The recent integration activity.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["events"],"properties":{"events":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["action","occurredAt"],"properties":{"action":{"type":"string","enum":["connected","directory-consent","runtime-consent","policy-saved","policy-published","overrides-saved","sender-granted","sender-revoked","sync-queued","sync-complete","sync-failed"]},"occurredAt":{"type":"string","format":"date-time"}}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperMicrosoft365Audit","summary":"List Microsoft 365 integration activity","description":"Returns the 50 most recent actions for the current connection. Request bodies, signatures and actor identities are excluded. This read remains available after cancellation.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365-audit:read"],"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365/sync":{"post":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"202":{"description":"The directory sync was queued.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["queued"],"properties":{"queued":{"type":"boolean","const":true}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active eligible Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"This operation does not accept a request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"queueDeveloperMicrosoft365Sync","summary":"Queue Microsoft 365 directory synchronization","description":"Queues the existing directory sync worker. The request returns before Microsoft Graph runs. Each connection has three queue requests per minute shared with the Portal.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365:sync"],"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/microsoft-365/disconnect":{"post":{"tags":["Developer Marketing Microsoft 365"],"parameters":[],"responses":{"200":{"description":"The confirmed Microsoft tenant was disconnected.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["disconnected"],"properties":{"disconnected":{"type":"boolean","const":true}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The request fields, selectors or resource identifiers are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer API bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token scope, current Space role or plan allowance does not permit this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found in the token Space or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body could not be read before the deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, connection, quota reservation or current resource state conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request rate limit was reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"disconnectDeveloperMicrosoft365","summary":"Disconnect a Microsoft 365 tenant","description":"Removes the current Space’s tenant binding and local directory, policy and grant data. Confirm the connected tenant UUID. The operation remains available after cancellation. Microsoft administrator consent and add-in installation are managed in Microsoft.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:microsoft365:disconnect"],"requestBody":{"required":true,"description":"Confirm the tenant GUID returned by setup status.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tenantId"],"properties":{"tenantId":{"type":"string","format":"uuid"}}},"example":{"tenantId":"1f297bf2-3d25-4bd0-8331-e705ea5fdabd"}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"provider","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/entitlement":{"get":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"Current product entitlement, or null when Marketing access is unavailable to the Space.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["entitlement"],"properties":{"entitlement":{"type":["object","null"],"oneOf":[{"type":"null"},{"type":"object","additionalProperties":false,"required":["tier","validUntil","microsoft365"],"properties":{"tier":{"type":"string","enum":["startup","business","enterprise"]},"validUntil":{"type":["string","null"],"format":"date-time"},"microsoft365":{"type":"boolean"}}}]}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMarketingEntitlement","summary":"Read Marketing entitlement","description":"Returns current Marketing eligibility and Microsoft 365 availability for the token Space. Billing identifiers and hosted billing sessions are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:access:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/marketing/portal-overview":{"get":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"Space counts and capacities. Individual sections require the relevant token scope and portal permission during the licensing rollout.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["generatedAt","limits","campaigns","brand","signatures","inspections"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"limits":{"type":"object","additionalProperties":false,"required":["campaigns","links","brandProfiles","brandBytes","brandFiles"],"properties":{"campaigns":{"type":"integer","minimum":0},"links":{"type":"integer","minimum":0},"brandProfiles":{"type":"integer","minimum":0},"brandBytes":{"type":"integer","minimum":0},"brandFiles":{"type":"integer","minimum":0}}},"campaigns":{"type":"object","oneOf":[{"type":"object","additionalProperties":false,"required":["status","data"],"properties":{"status":{"type":"string","const":"ready"},"data":{"type":"object","additionalProperties":false,"required":["total","active","savedLinks"],"properties":{"total":{"type":"integer","minimum":0},"active":{"type":"integer","minimum":0},"savedLinks":{"type":"integer","minimum":0}}}}},{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","const":"unavailable"},"reason":{"type":"string","enum":["setup_required","temporary","capacity","permission_required"]}}}]},"brand":{"type":"object","oneOf":[{"type":"object","additionalProperties":false,"required":["status","data"],"properties":{"status":{"type":"string","const":"ready"},"data":{"type":"object","additionalProperties":false,"required":["profiles"],"properties":{"profiles":{"type":"integer","minimum":0},"usedBytes":{"type":"integer","minimum":0},"readyFiles":{"type":"integer","minimum":0},"pendingFiles":{"type":"integer","minimum":0}}}}},{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","const":"unavailable"},"reason":{"type":"string","enum":["setup_required","temporary","capacity","permission_required"]}}}]},"signatures":{"type":"object","oneOf":[{"type":"object","additionalProperties":false,"required":["status","data"],"properties":{"status":{"type":"string","const":"ready"},"data":{"type":"object","additionalProperties":false,"required":["total","published"],"properties":{"total":{"type":"integer","minimum":0},"published":{"type":"integer","minimum":0}}}}},{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","const":"unavailable"},"reason":{"type":"string","enum":["setup_required","temporary","capacity","permission_required"]}}}]},"inspections":{"type":"object","oneOf":[{"type":"object","additionalProperties":false,"required":["status","data"],"properties":{"status":{"type":"string","const":"ready"},"data":{"type":"object","additionalProperties":false,"required":["historyEnabled","retentionDays"],"properties":{"historyEnabled":{"type":"boolean"},"retentionDays":{"type":"integer","minimum":1,"maximum":30}}}}},{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","const":"unavailable"},"reason":{"type":"string","enum":["setup_required","temporary","capacity","permission_required"]}}}]}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMarketingPortalOverview","summary":"Read Marketing workspace totals","description":"Returns current plan capacities and aggregate campaign, Brand Kit, signature and inspection availability. Use each resource’s own scope to read records.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:overview:read"],"x-rate-limit":{"requestCredits":5,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"directory","windowSeconds":3600,"tokenRequests":40,"spaceRequests":100}}}},"/api/v1/marketing/brand-kit/assets":{"post":{"tags":["Developer Marketing"],"parameters":[{"in":"query","name":"brandId","required":true,"schema":{"type":"string","format":"uuid"},"description":"The parent profile in the token Space."},{"in":"query","name":"name","required":true,"schema":{"type":"string","minLength":1,"maxLength":80},"description":"The logo’s display label."},{"in":"query","name":"variant","required":true,"schema":{"type":"string","enum":["light","dark","mark","other"]}},{"in":"query","name":"originalByteSize","required":false,"schema":{"type":"integer","minimum":1,"maximum":8388608},"description":"Pre-optimization byte count, at least the size of the uploaded raster. Defaults to its actual size."},{"in":"header","name":"Idempotency-Key","required":true,"description":"Use one unique key per request. Reuse it with the same input for seven days to recover a committed receipt.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"The committed logo receipt. Use the separate read permission to download it.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Idempotency-Replayed":{"description":"Set to true when this response reuses a committed receipt.","schema":{"type":"string","const":"true"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["recordId","replayed"],"properties":{"recordId":{"type":"string","format":"uuid"},"replayed":{"type":"boolean"}}}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The idempotency key conflicts, or an earlier attempt is pending upload or cleanup.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the supported size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Expected PNG, JPEG or WebP raster bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"uploadDeveloperMarketingBrandAsset","summary":"Upload a private Brand Kit logo","description":"Send raw PNG, JPEG or WebP bytes. The server checks the parent profile, actual raster, maximum 2 MiB, maximum 4096 pixels per side and current Space allowance. Repeat the same upload with the same key to recover a committed receipt.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:brand-assets:write"],"requestBody":{"required":true,"content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"x-rate-limit":{"requestCredits":10,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"file_transfer","windowSeconds":3600,"tokenRequests":24,"spaceRequests":60}}}},"/api/v1/marketing/brand-kit/assets/{assetId}":{"get":{"tags":["Developer Marketing"],"parameters":[{"in":"path","name":"assetId","required":true,"description":"The ID of the logo in the token Space.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Validated raster bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"Download response disposition.","schema":{"type":"string","const":"attachment"}},"Content-Length":{"description":"Length of the stored raster in bytes.","schema":{"type":"integer","minimum":1,"maximum":2097152}}},"content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The logo is changing. Retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperMarketingBrandAsset","summary":"Download a private Brand Kit logo","description":"Returns the exact validated raster from a ready logo in the token Space. Use the Brand Kit metadata operation to find an asset ID. The response is a private attachment.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:brand-assets:read"],"x-rate-limit":{"requestCredits":10,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"file_transfer","windowSeconds":3600,"tokenRequests":24,"spaceRequests":60}}},"patch":{"tags":["Developer Marketing"],"parameters":[{"in":"path","name":"assetId","required":true,"description":"The ID of the logo in the token Space.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The logo metadata update receipt.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["recordId","replayed"],"properties":{"recordId":{"type":"string","format":"uuid"},"replayed":{"type":"boolean"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The logo is changing. Retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the supported size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request content type is unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateDeveloperMarketingBrandAsset","summary":"Change a Brand Kit logo’s label and variant","description":"Replaces the display label and variant for a ready asset in the token Space. Logo bytes and the parent profile stay attached to the same asset.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:brand-assets:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","variant"],"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"variant":{"type":"string","enum":["light","dark","mark","other"]}}},"example":{"name":"Primary mark","variant":"mark"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Marketing"],"parameters":[{"in":"path","name":"assetId","required":true,"description":"The ID of the logo in the token Space.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The logo deletion receipt.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Idempotency-Replayed":{"description":"Set to true when this response reuses a committed receipt.","schema":{"type":"string","const":"true"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["recordId","replayed"],"properties":{"recordId":{"type":"string","format":"uuid"},"replayed":{"type":"boolean"}}}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The logo upload or removal is pending. Retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteDeveloperMarketingBrandAsset","summary":"Remove a Brand Kit logo","description":"Removes the private raster and then releases its storage allowance. Repeated deletion is safe. An absent asset returns the same successful deletion receipt without confirming ownership.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:brand-assets:write"],"x-rate-limit":{"requestCredits":10,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"file_transfer","windowSeconds":3600,"tokenRequests":24,"spaceRequests":60}}}},"/api/v1/marketing/qr":{"post":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"Generated SVG markup, exact payload, request nonce and readability guidance.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["requestId","payload","svg","version","moduleCount","issues"],"properties":{"requestId":{"type":"string","format":"uuid"},"payload":{"type":"string"},"svg":{"type":"string","description":"Server-generated SVG markup."},"version":{"type":"integer","minimum":1,"maximum":40},"moduleCount":{"type":"integer"},"issues":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","level","title","message"],"properties":{"id":{"type":"string"},"level":{"type":"string","enum":["error","warning","info"]},"title":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The Marketing plan or quota state is changing. Retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the supported size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request content type or inline logo image is unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"The URL exceeds capacity at the selected error correction level.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token, Space, or QR generation allowance is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"generateDeveloperMarketingQr","summary":"Generate a Marketing QR code","description":"Encodes an absolute HTTP(S) URL with the selected design and charges the token Space’s QR allowance. Optional logos must be supported inline raster data. Encoding makes no network request to the destination.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:qr:generate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["requestId","payload","design"],"properties":{"requestId":{"type":"string","format":"uuid","description":"Client request nonce used to discard stale responses."},"payload":{"type":"string","description":"Exact absolute HTTP(S) URL, at most 1200 characters, including its original query and fragment.","maxLength":1200},"design":{"type":"object","additionalProperties":false,"required":["foreground","background","transparentBackground","moduleStyle","eyeStyle","errorCorrection","quietZone","logoDataUrl","logoScale","logoBackdrop"],"properties":{"foreground":{"type":"string","description":"Three- or six-digit hex color."},"background":{"type":"string","description":"Three- or six-digit hex color."},"transparentBackground":{"type":"boolean"},"moduleStyle":{"type":"string","enum":["square","rounded","dots"]},"eyeStyle":{"type":"string","enum":["square","rounded","circle"]},"errorCorrection":{"type":"string","enum":["L","M","Q","H"]},"quietZone":{"type":"number","minimum":0,"maximum":10},"logoDataUrl":{"type":["string","null"],"description":"Base64 data URL for a complete static PNG, JPEG or WebP image. At most 2 MiB decoded and 512 pixels per side."},"logoScale":{"type":"number","minimum":0.1,"maximum":0.3},"logoBackdrop":{"type":"boolean"}}}}},"example":{"requestId":"4e9168d6-d26b-48a2-88d9-671772297afb","payload":"https://example.com/launch?utm_source=poster","design":{"foreground":"#172036","background":"#ffffff","transparentBackground":false,"moduleStyle":"square","eyeStyle":"square","errorCorrection":"M","quietZone":4,"logoDataUrl":null,"logoScale":0.2,"logoBackdrop":false}}}}},"x-rate-limit":{"requestCredits":8,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"rendering","windowSeconds":3600,"tokenRequests":30,"spaceRequests":80}}}},"/api/v1/marketing/site-inspections":{"get":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"Retained summaries with the applicable history limits.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["entries","historyLimit","retentionDays"],"properties":{"entries":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["id","url","finalUrl","score","passed","warnings","failed","createdAt"],"properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri","maxLength":2048},"finalUrl":{"type":"string","format":"uri","maxLength":2048},"score":{"type":"integer","minimum":0,"maximum":100},"passed":{"type":"integer","minimum":0,"maximum":1000},"warnings":{"type":"integer","minimum":0,"maximum":1000},"failed":{"type":"integer","minimum":0,"maximum":1000},"createdAt":{"type":"string","format":"date-time"}}}},"historyLimit":{"type":"integer","minimum":0,"maximum":100},"retentionDays":{"type":"integer","minimum":1,"maximum":30}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperMarketingInspections","summary":"Read saved website inspection summaries","description":"Returns this Space’s explicitly saved summaries still within the current retention period. Query strings and fragments are omitted from historical addresses.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:inspections:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"Passive observations, a score and optional history-save receipt.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["requestedUrl","finalUrl","statusCode","responseTimeMs","redirects","inspectedAt","preview","summary","checks","historySaveStatus","historyId"],"properties":{"requestedUrl":{"type":"string","format":"uri"},"finalUrl":{"type":"string","format":"uri"},"statusCode":{"type":"integer","minimum":100,"maximum":599},"responseTimeMs":{"type":"integer","minimum":0},"redirects":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","statusCode"],"properties":{"url":{"type":"string","format":"uri"},"statusCode":{"type":"integer"}}},"maxItems":4},"inspectedAt":{"type":"string","format":"date-time"},"preview":{"type":"object","additionalProperties":false,"required":["title","description","siteName","hostname","imageDeclared"],"properties":{"title":{"type":["string","null"]},"description":{"type":["string","null"]},"siteName":{"type":["string","null"]},"hostname":{"type":"string"},"imageDeclared":{"type":"boolean"}}},"summary":{"type":"object","additionalProperties":false,"required":["score","passed","warnings","failed"],"properties":{"score":{"type":"integer","minimum":0,"maximum":100},"passed":{"type":"integer","minimum":0},"warnings":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0}}},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","category","status","label","detail"],"properties":{"id":{"type":"string"},"category":{"type":"string","enum":["seo","social","ai","accessibility","technical","security"]},"status":{"type":"string","enum":["pass","warn","fail","info"]},"label":{"type":"string"},"detail":{"type":"string"},"priority":{"type":"string","enum":["high","medium","low"]},"certainty":{"type":"string","enum":["observed","needs-review","optional"]}}}},"historySaveStatus":{"type":"string","enum":["not-requested","saved","failed"]},"historyId":{"type":["string","null"],"format":"uuid"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required grant or the hostname is not authorized for this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The Marketing plan or quota state is changing. Retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds the supported size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"JSON is required or the destination is not HTML.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"The HTML exceeds the bounded analysis work limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token, Space or inspection allowance is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"502":{"description":"The destination could not be inspected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"504":{"description":"The destination did not respond before the inspection deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"runDeveloperMarketingInspection","summary":"Run a passive website inspection on an authorized host","description":"Analyzes one public HTML page and bounded discovery files within the approved Space host. A managed domain permits its www alias. Redirects and ancillary requests are checked at every hop. Raw response content and share images are excluded. Explicitly request history to retain a summary.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:inspections:run"],"x-conditional-scopes":{"marketing:inspections:save":"Required when options.saveHistory is true."},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048,"minLength":1,"description":"Absolute HTTP(S) address on a default port. The hostname must be managed or currently verified in this Space. Credentials, query strings and fragments are disallowed."},"options":{"type":"object","additionalProperties":false,"required":[],"properties":{"verifySitemap":{"type":"boolean","default":true},"saveHistory":{"type":"boolean","default":false}}}}},"example":{"url":"https://example.com/","options":{"verifySitemap":true,"saveHistory":false}}}}},"x-rate-limit":{"requestCredits":15,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"inspection","windowSeconds":3600,"tokenRequests":8,"spaceRequests":20}}},"delete":{"tags":["Developer Marketing"],"parameters":[],"responses":{"200":{"description":"The history clear completed.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["deleted"],"properties":{"deleted":{"type":"boolean","const":true}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported parameters or invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Marketing entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required Marketing grant or Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The resource was not found or the Developer API is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"Inspection history is changing. Retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Marketing operation is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"clearDeveloperMarketingInspectionHistory","summary":"Clear saved website inspection summaries","description":"Deletes all saved inspection summaries for the token Space. The clear is recorded in the Space audit log.","security":[{"developerToken":[]}],"x-required-scopes":["marketing:inspections:delete"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/backup":{"get":{"tags":["Developer Compliance"],"parameters":[],"responses":{"200":{"description":"The audited portable backup.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"required":true,"description":"Attachment filename for the portable JSON backup.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceBackup"}}}},"400":{"description":"The operation does not accept query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer Bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance subscription or eligible grant is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Current Space access, required token scopes and applicable plan limits are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace revision changed while the backup was prepared. Retry to download the current version.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request or workspace exceeds the operation’s backup limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request limit has been reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The backup operation or its required audit could not be confirmed. Retry after a short delay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"downloadComplianceWorkspaceBackup","summary":"Download a portable Compliance backup","description":"Downloads the version 2 workspace backup with pinned framework assessments, explicit decisions and original snapshot payloads. Private file bodies are embedded as data URLs. The export allows 8 MB of JSON, up to 24 attachment references, and 4 MB of file bytes. A current token and durable audit entry are required before the backup is returned.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:backups:read"],"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/catalog":{"get":{"tags":["Developer Compliance Workspace"],"parameters":[],"responses":{"200":{"description":"Version 1 Compliance starter catalog.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","frameworks","controlTemplates","assuranceStarters","releases"],"properties":{"schemaVersion":{"type":"integer","const":1},"releases":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkReleaseSummary"}},"frameworks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name","area"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"area":{"type":"string"}}}},"controlTemplates":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","title","description","suggestedCadence","evidenceName","evidenceKind","acceptanceCriteria","reference"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"suggestedCadence":{"type":"string"},"evidenceName":{"type":"string"},"evidenceKind":{"type":"string","enum":["Period-based","Point-in-time","Standing document"]},"acceptanceCriteria":{"type":"string"},"reference":{"type":"object","additionalProperties":false,"required":["label","url"],"properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}},"assuranceStarters":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["label","description","action","starter"],"properties":{"label":{"type":"string"},"description":{"type":"string"},"action":{"type":"string"},"starter":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"type":"string","enum":["Certification","Attestation report","Self-assessment"]},"title":{"type":"string"},"standardEdition":{"type":"string"},"nextMilestone":{"type":"string"}}}}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Current Space administrator access and the required scope are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Compliance access could not be verified.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperComplianceCatalog","summary":"List published framework releases and Compliance templates","description":"Returns reviewed edition and language choices, framework labels, control templates and assurance draft starters. A template can be applied by saving its details as a workspace record.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:catalog:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/catalog/releases/{releaseId}/requirements":{"get":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"releaseId","required":true,"schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"maximum":50000,"default":0}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"in":"query","name":"search","schema":{"type":"string","description":"A search term of up to 200 characters."}}],"responses":{"200":{"description":"Matching source requirement identifiers in publisher order.","content":{"application/json":{"schema":{"type":"object","required":["requirements","total","offset","limit","release"],"properties":{"requirements":{"type":"array","maxItems":50,"items":{"type":"object","required":["id","title","locator"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"locator":{"type":"string"}}}},"total":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":50},"release":{"$ref":"#/components/schemas/DeveloperFrameworkRequirementRelease"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid pagination, search term or query field.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Requires current Compliance access, the catalog grant and a release that permits external distribution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The catalog could not be loaded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperFrameworkRequirements","summary":"List requirements in a published release","description":"Returns assessable source items for the selected edition and language, with their identifiers, locators and release notices. Pass a search term to narrow the result and use offset and limit to page through matching items.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:catalog:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/catalog/releases/{releaseId}/requirements/{requirementId}":{"get":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"releaseId","required":true,"schema":{"type":"string"}},{"in":"path","name":"requirementId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Requirement, source context and release notices.","content":{"application/json":{"schema":{"type":"object","required":["requirement","release","context"],"properties":{"requirement":{"$ref":"#/components/schemas/DeveloperFrameworkSourceNode"},"release":{"$ref":"#/components/schemas/DeveloperFrameworkRequirementRelease"},"context":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkSourceNode"}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported query or invalid selector.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Requires current Compliance access, the catalog grant and a release that permits external distribution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The release or requirement is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The catalog could not be loaded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperFrameworkRequirement","summary":"Read a source requirement and its guidance","description":"Returns the requirement at its release-local identifier, contextual source material and applicable attribution. Publisher wording and Dashio guidance occupy separate fields. URL-encode the requirement identifier as a path segment.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:catalog:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/assessments":{"get":{"tags":["Developer Framework Assessments"],"parameters":[],"responses":{"200":{"description":"Assessment headers ordered by creation time.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentSummary"}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperFrameworkAssessments","summary":"List assessments in the connected Space","description":"Returns assessment scopes, optimistic revisions and release pins in creation order. The credential selects the Space.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:assessments:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Framework Assessments"],"parameters":[],"responses":{"200":{"description":"Persisted assessment with every applicable catalog candidate initialized as unassessed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentDetail"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"Request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json for the request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"The selected release has been superseded. Choose its corrected release.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createDeveloperFrameworkAssessment","summary":"Start a framework assessment","description":"Select a published release, scope and inclusive assessment period. Supply a new UUID for a retryable creation. All assessable requirements start unassessed.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:assessments:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["id","releaseId","scope","periodStart","periodEnd"],"properties":{"id":{"type":"string","format":"uuid"},"releaseId":{"type":"string"},"scope":{"type":"string","description":"Up to 2000 characters."},"periodStart":{"type":"string","format":"date"},"periodEnd":{"type":"string","format":"date"}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/assessments/{assessmentId}":{"get":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"assessmentId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Hydrated assessment, tenant decisions, record links, snapshot dates and progress counts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentDetail"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperFrameworkAssessment","summary":"Read a pinned framework assessment","description":"Returns the connected Space’s decisions, linked controls and evidence references, snapshot index and progress for the pinned release.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:assessments:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"put":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"assessmentId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Updated assessment and revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentDetail"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"Request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json for the request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateDeveloperFrameworkAssessmentDecision","summary":"Save a framework requirement decision","description":"Replaces one assessment entry at the supplied revision. The server checks that the requirement is assessable on the pinned release and that linked controls and evidence belong to the connected Space.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:assessments:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","requirementId","applicability","implementation","rationale","controlIds","evidenceIds"],"properties":{"revision":{"type":"integer","minimum":0},"requirementId":{"type":"string"},"applicability":{"type":"string","enum":["unassessed","applicable","not-applicable"]},"implementation":{"type":"string","enum":["unassessed","not-started","in-progress","implemented"]},"rationale":{"type":"string","description":"Up to 4000 characters."},"controlIds":{"type":"array","maxItems":2000,"description":"Distinct workspace record IDs.","items":{"type":"string"}},"evidenceIds":{"type":"array","maxItems":2000,"description":"Distinct workspace record IDs.","items":{"type":"string"}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/assessments/{assessmentId}/upgrade-preview":{"get":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"assessmentId","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"releaseId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Added, removed, changed and unchanged requirements and possible mappings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentUpgradePreview"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"previewDeveloperFrameworkAssessmentUpgrade","summary":"Preview a framework assessment upgrade","description":"Compares the pinned release with a published target for the same framework and language. Possible mappings are suggestions for explicit review.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:assessments:read"],"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/assessments/{assessmentId}/upgrade":{"post":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"assessmentId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"New assessment; source assessment and historical exports retain their original edition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentDetail"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"Request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json for the request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"The target release has been superseded. Choose its corrected release.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"upgradeDeveloperFrameworkAssessment","summary":"Create an assessment on a new release","description":"Forks the supplied revision of an existing assessment onto a published release. Explicitly selected mappings carry affected decisions into review. The predecessor and its historical snapshots remain accessible.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:assessments:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["id","revision","releaseId"],"properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":0},"releaseId":{"type":"string"},"mappings":{"type":"array","maxItems":2000,"items":{"type":"object","required":["kind","from","to"],"properties":{"kind":{"type":"string","enum":["renumber","split","merge"]},"from":{"type":"array","items":{"type":"string"}},"to":{"type":"array","items":{"type":"string"}}}}}}}}}},"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/assessments/{assessmentId}/snapshots":{"post":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"assessmentId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Immutable snapshot identifier, revision, date and actor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentSnapshot"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"Request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json for the request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createDeveloperFrameworkAssessmentSnapshot","summary":"Capture an assessment handoff","description":"Supply a new snapshot UUID and current revision to record a dated handoff. The capture preserves the release pin, decisions and linked record metadata for later export.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:exports:create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["id","revision"],"properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":0}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/assessments/{assessmentId}/snapshots/{snapshotId}":{"get":{"tags":["Developer Framework Assessments"],"parameters":[{"in":"path","name":"assessmentId","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"snapshotId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Dated JSON handoff with complete release attribution, captured decisions, gaps and evidence references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentHandoff"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid assessment input or reference.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer credential is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Active Compliance entitlement required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The credential lacks the required scope, current product action or source rights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The assessment, snapshot or published release is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision or idempotency key conflicts with saved state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"Request or storage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The assessment could not be loaded or saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperFrameworkAssessmentSnapshot","summary":"Download a captured assessment handoff","description":"Returns an authorized snapshot with its pinned source, original notices, recorded tenant decisions and open gaps. Its schema version identifies the historical rendering contract.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:exports:create"],"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/catalog/releases/{releaseId}":{"get":{"tags":["Developer Compliance Workspace"],"parameters":[{"in":"path","name":"releaseId","required":true,"schema":{"type":"string","description":"Published release ID, up to 160 characters."}}],"responses":{"200":{"description":"Published framework release.","content":{"application/json":{"schema":{"type":"object","required":["release"],"properties":{"release":{"$ref":"#/components/schemas/DeveloperFrameworkRelease"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported query parameters.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Valid developer token required.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"Compliance subscription required.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Requires current Compliance access, the catalog grant and a release that permits external distribution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Release unavailable.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"Request budget exhausted. Edge traffic limits can also return 429.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Compliance unavailable.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperFrameworkRelease","summary":"Read a published framework release","description":"Returns publisher requirements and supporting material in source order, separately identified Dashio guidance, the exact license, attribution and upstream artifacts. The release ID pins an edition, language and revision.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:catalog:read"],"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/contacts":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceContact"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceContacts","summary":"List contacts","description":"Lists member contact IDs, names and status in the token’s Space. Unresolved historical contacts appear as inactive and retain their saved IDs. Requires an active Compliance entitlement. Email addresses, avatars and notes are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:contacts:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/contacts/{recordId}":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceContact"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceContact","summary":"Get a contact","description":"Reads one contact ID, name and status in the token’s Space. An unresolved historical contact appears as inactive and retains its saved ID. Requires an active Compliance entitlement. Email addresses, avatars and notes are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:contacts:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/entitlements":{"get":{"tags":["Developer Compliance Workspace"],"parameters":[],"responses":{"200":{"description":"Current Compliance access and plan allowances.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["entitlement"],"properties":{"entitlement":{"type":["object","null"],"oneOf":[{"type":"null"},{"type":"object","additionalProperties":false,"required":["tier","validUntil","activeEditors","activeSuppliers","evidenceStorageMb","recurringQuestionnaires"],"properties":{"tier":{"type":"string","enum":["startup","business","enterprise"]},"validUntil":{"type":["string","null"],"format":"date-time","description":"Current subscription period end, or null for a permanent grant."},"activeEditors":{"type":"integer","minimum":1},"activeSuppliers":{"type":"integer","minimum":1},"evidenceStorageMb":{"type":"integer","minimum":1,"description":"Evidence storage limit in decimal megabytes."},"recurringQuestionnaires":{"type":"boolean","description":"Whether the plan includes recurring questionnaire scheduling."}}}]}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"403":{"description":"Current Space administrator access and the required scope are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Access or entitlement state is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperComplianceEntitlements","summary":"Read Compliance access and allowances","description":"Returns the token Space’s current Compliance tier and limits. A null entitlement means the Space has no active plan or eligible grant.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:entitlements:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/evidence":{"get":{"tags":["Developer Compliance Evidence"],"parameters":[{"name":"limit","in":"query","description":"Maximum evidence records per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","description":"Use the nextCursor returned by the previous evidence page.","schema":{"type":"string"}}],"responses":{"200":{"description":"The saved evidence page and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","records","pagination"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"records":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["id","name","status","attachmentAvailable"],"properties":{"id":{"type":"string","description":"Stable evidence record ID."},"name":{"type":"string","description":"Saved name, shortened to 512 characters when longer."},"status":{"type":"string","description":"Saved internal review status, such as Verified."},"attachmentAvailable":{"type":"boolean","description":"True when the saved Verified record has a current internal attachment link."}}}},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}},"example":{"revision":17,"records":[{"id":"EV-004","name":"Data retention schedule","status":"Verified","attachmentAvailable":true}],"pagination":{"limit":20,"nextCursor":null}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid pagination or unexpected query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks compliance:evidence:read or its Space access has changed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace revision changed. Restart pagination without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The API or saved evidence is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperComplianceEvidence","summary":"List Compliance evidence","description":"Returns saved evidence IDs, names, review status and whether each verified record links an internal attachment. The cursor remains valid until the workspace revision changes. Attachment bytes require compliance:evidence:download.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:evidence:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Workflows"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceEvidence","summary":"Create Compliance evidence","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:evidence:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"controlId":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"description":{"type":"string"},"sourceUrl":{"type":"string"},"evidenceKind":{"type":"string","enum":["Period-based","Point-in-time","Standing document"]},"collectedOn":{"type":"string"},"coverageStart":{"type":"string"},"coverageEnd":{"type":"string"},"renewalDate":{"type":"string"},"sourceSystem":{"type":"string"},"acceptanceCriteria":{"type":"string"},"additionalControlIds":{"type":"array","items":{"type":"string"}}}},"recordId":{"type":"string","minLength":1,"maxLength":180}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/evidence/{evidenceId}/attachment":{"get":{"tags":["Developer Compliance Evidence"],"parameters":[{"in":"path","name":"evidenceId","required":true,"description":"Evidence record ID from the evidence index. Encode it as one URL path segment.","schema":{"type":"string","example":"EV-004"}}],"responses":{"200":{"description":"The verified private file, up to 1 MB, sent as an attachment.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"An attachment disposition with a safe filename.","schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid evidence ID or unexpected query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks compliance:evidence:download or its Space access has changed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"No verified attachment exists for this record in the token Space, or the operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The current evidence attachment changed while preparing the download.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The evidence or mandatory audit could not be confirmed. No file was released.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"downloadDeveloperComplianceEvidence","summary":"Download verified Compliance evidence","description":"Downloads the private file linked to a saved evidence record in Verified status. The file is checked and the disclosure is audited before release. Supplier questionnaire quarantine, inline previews and external source URLs are outside this operation.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:evidence:download"],"x-rate-limit":{"requestCredits":10,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"file_transfer","windowSeconds":3600,"tokenRequests":24,"spaceRequests":60}}}},"/api/v1/compliance/exports":{"post":{"tags":["Developer Compliance Exports"],"parameters":[],"responses":{"200":{"description":"The audited report in its native format. Save the response body to a file.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"An attachment disposition with a safe filename.","schema":{"type":"string"}}},"content":{"text/csv":{"schema":{"type":"string","description":"CSV for statements, approved questionnaires, audit evidence indexes or requested tables."}},"text/plain":{"schema":{"type":"string","description":"Internal evidence, audit or Trust Center report text."}},"application/json":{"schema":{"type":["array","object"],"oneOf":[{"type":"array","maxItems":2000,"items":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]}},"description":"Selected table or risk records with requested columns."},{"type":"object","required":["format","generatedAt","scope","interpretation","contents","controls","evidenceIndex"],"properties":{"format":{"type":"string","const":"compliance-portal-audit-preparation-v1"},"generatedAt":{"type":"string","format":"date-time"},"scope":{"$ref":"#/components/schemas/DeveloperComplianceAuditExportScope"},"interpretation":{"type":"string"},"contents":{"type":"object","required":["fileContentsIncluded","externalLinkAccess"],"additionalProperties":false,"properties":{"fileContentsIncluded":{"type":"boolean","const":false},"externalLinkAccess":{"type":"string","const":"Not checked"}}},"controls":{"type":"array","items":{"type":"object","description":"Saved control review and preparation gaps."}},"evidenceIndex":{"type":"array","items":{"type":"object","description":"Saved evidence metadata and review decisions, without private file bodies."}}},"additionalProperties":false,"description":"Audit preparation snapshot."}]}},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary","description":"Verified private Trust document attachment."}}}},"400":{"description":"Invalid export selector, malformed JSON or unexpected query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks compliance:exports:create or its Space access has changed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The saved record, selected revision or operation is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive within the time limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The selected records changed or the disclosure requires current approval.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request or generated file exceeds the size or row limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request must use application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The report or mandatory audit could not be confirmed. No file was released.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"prepareDeveloperComplianceExport","summary":"Prepare and download a Compliance export","description":"Generates a report from saved records in the token Space and returns the downloadable file. Questionnaire responses require approval. Approved Trust request downloads require approval for the current resource. Internal review copies are distinct from approved disclosures. The response omits storage URLs and the API never fetches user-supplied external sources. The request is limited to 512 KiB and the file to 2 MB. Table reports contain only the selected columns and at most 2,000 rows.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:exports:create"],"requestBody":{"required":true,"description":"Select one saved report. For a table, supply the exact saved record IDs in the desired order. auditScope is accepted only for the Audit Preparation table.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceExportRequest"},"example":{"type":"table","exportKey":"controls","format":"csv","scope":"selected","recordIds":["DP-04"],"columns":["id","title","status"]}}}},"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/import":{"post":{"tags":["Developer Compliance"],"parameters":[],"responses":{"200":{"description":"Audited import receipt. The response does not contain workspace records.","content":{"application/json":{"schema":{"type":"object","required":["revision","alreadyImported"],"additionalProperties":false,"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"alreadyImported":{"type":"boolean","description":"True if this backup was previously applied to the same Space."}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The JSON envelope, backup data, revision, or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer Bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance subscription or eligible grant is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Current Space access, required token scopes and applicable plan limits are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive before its deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace revision changed or the import contains conflicting record IDs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request or workspace exceeds the operation’s backup limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request must use an application/json content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"This backup exceeds API file import limits or would create an approved Trust Center disclosure. Use the Compliance Portal to restore it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request limit has been reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The backup operation or its required audit could not be confirmed. Retry after a short delay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"commitComplianceBackupImport","summary":"Apply a Compliance backup import","description":"Imports missing record IDs at the current workspace revision. A conflicting saved record prevents the import. Repeating an applied backup returns an idempotent receipt. Importing or linking files requires compliance:evidence:write. New file imports allow up to 20 files and 4 MB of file bytes. Creating an approved Trust Center disclosure requires the Portal. The JSON request is limited to 8 MB.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:imports:write"],"x-conditional-scopes":{"compliance:evidence:write":"Required when the import uploads or adds a link to an attachment."},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["backup","revision"],"additionalProperties":false,"properties":{"backup":{"$ref":"#/components/schemas/DeveloperComplianceBackupInput"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"example":{"backup":{"schemaVersion":1,"collections":{"compliance:contacts":[],"compliance:controls":[],"compliance:evidence":[],"compliance:statements-of-applicability":[],"compliance:questionnaires":[],"compliance:questionnaire-answers":[],"compliance:risks":[],"compliance:suppliers":[],"compliance:incidents":[],"compliance:training":[],"compliance:training-courses":[],"compliance:training-policies":[],"compliance:trust:certifications":[],"compliance:trust:documents":[],"compliance:trust:subprocessors":[],"compliance:trust:access-requests":[]}},"revision":0}}}},"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/import/preview":{"post":{"tags":["Developer Compliance"],"parameters":[],"responses":{"200":{"description":"Read-only preview. No records or attachment content are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceImportPreview"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The JSON envelope, backup data, revision, or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid Developer Bearer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance subscription or eligible grant is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Current Space access, required token scopes and applicable plan limits are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive before its deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request or workspace exceeds the operation’s backup limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request must use an application/json content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request limit has been reached. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The backup operation or its required audit could not be confirmed. Retry after a short delay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"previewComplianceBackupImport","summary":"Preview a Compliance backup import","description":"Validates a version 1 or version 2 portable backup and compares it with the token’s Space. Returns collection and assessment history counts, the current revision, merge conflicts and any contents requiring Portal restoration. The JSON request is limited to 8 MB.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:imports:preview"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["backup"],"additionalProperties":false,"properties":{"backup":{"$ref":"#/components/schemas/DeveloperComplianceBackupInput"}}},"example":{"backup":{"schemaVersion":1,"collections":{"compliance:contacts":[],"compliance:controls":[],"compliance:evidence":[],"compliance:statements-of-applicability":[],"compliance:questionnaires":[],"compliance:questionnaire-answers":[],"compliance:risks":[],"compliance:suppliers":[],"compliance:incidents":[],"compliance:training":[],"compliance:training-courses":[],"compliance:training-policies":[],"compliance:trust:certifications":[],"compliance:trust:documents":[],"compliance:trust:subprocessors":[],"compliance:trust:access-requests":[]}}}}}},"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/incidents":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceIncident"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceIncidents","summary":"List incidents","description":"Lists saved incidents in the token’s Space. Requires an active Compliance entitlement. Includes title, severity, status, and reported time. Affected systems, descriptions, contacts, tasks, and postmortems are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:incidents:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/incidents/{recordId}":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceIncident"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceIncident","summary":"Get a incident","description":"Reads a saved incident summary in the token’s Space. Requires an active Compliance entitlement. Includes title, severity, status, and reported time. Affected systems, descriptions, contacts, tasks, and postmortems are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:incidents:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/questionnaire-answers":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceQuestionnaireAnswer"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceQuestionnaireAnswers","summary":"List reusable questionnaire answers","description":"Lists saved reusable questionnaire answers in the token’s Space. Requires an active Compliance entitlement. Includes answer identifiers and titles. Answer text and scope are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaire-answers:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Workflows"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceQuestionnaireAnswer","summary":"Create Compliance reusable questionnaire answer","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaire-answers:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"answer":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"}}},"recordId":{"type":"string","minLength":1,"maxLength":180}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/questionnaire-answers/{recordId}":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceQuestionnaireAnswer"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceQuestionnaireAnswer","summary":"Get a reusable questionnaire answer","description":"Reads a saved reusable questionnaire answer summary in the token’s Space. Requires an active Compliance entitlement. Includes answer identifiers and titles. Answer text and scope are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaire-answers:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceQuestionnaireAnswer","summary":"Update Compliance reusable questionnaire answer","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaire-answers:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"answer":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."},{"in":"query","name":"revision","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceQuestionnaireAnswer","summary":"Delete Compliance reusable questionnaire answer","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaire-answers:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/questionnaires":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceQuestionnaire"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceQuestionnaires","summary":"List questionnaires","description":"Lists saved questionnaires in the token’s Space. Requires an active Compliance entitlement. Includes the title, direction, due date, and workflow status. Contacts, questionnaire contents, artifacts, and review notes are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaires:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Workflows"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceQuestionnaire","summary":"Create Compliance questionnaire","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaires:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"counterparty":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"},"supplierId":{"type":"string"},"dueDate":{"type":"string"},"sourceUrl":{"type":"string"},"direction":{"type":"string","enum":["Customer response","Supplier assessment"]},"serviceType":{"type":"string","enum":["Software","Cloud service","Professional services","Other"]},"questions":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireQuestion"}},"artifacts":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireArtifact"}}}},"recordId":{"type":"string","minLength":1,"maxLength":180}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/questionnaires/{recordId}":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceQuestionnaire"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceQuestionnaire","summary":"Get a questionnaire","description":"Reads a saved questionnaire summary in the token’s Space. Requires an active Compliance entitlement. Includes the title, direction, due date, and workflow status. Contacts, questionnaire contents, artifacts, and review notes are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaires:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceQuestionnaire","summary":"Update Compliance questionnaire","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaires:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"counterparty":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"sourceUrl":{"type":"string"},"serviceType":{"type":"string","enum":["Software","Cloud service","Professional services","Other"]},"questions":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireQuestion"}},"artifacts":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireArtifact"}}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."},{"in":"query","name":"revision","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceQuestionnaire","summary":"Delete Compliance questionnaire","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaires:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/statements-of-applicability":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceStatementOfApplicability"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceStatementsOfApplicability","summary":"List statements of applicability","description":"Lists saved statements of applicability in the token’s Space. Requires an active Compliance entitlement. Includes the title, source edition, and Annex A review state. Scope text, applicability decisions, and revision history are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:statements-of-applicability:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/statements-of-applicability/{recordId}":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceStatementOfApplicability"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceStatementOfApplicability","summary":"Get a statement of applicability","description":"Reads a saved statement of applicability summary in the token’s Space. Requires an active Compliance entitlement. Includes the title, source edition, and Annex A review state. Scope text, applicability decisions, and revision history are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:statements-of-applicability:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{recordId}":{"get":{"tags":["Developer Compliance Records"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceSupplier"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceSupplier","summary":"Get a supplier","description":"Reads a saved supplier summary in the token’s Space. Requires an active Compliance entitlement. Includes assessment metadata. Contact details, documents, schedules, and notes are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:suppliers:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."},{"in":"query","name":"revision","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceSupplier","summary":"Delete Compliance supplier","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:suppliers:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{supplierId}/delivery":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"supplierId","required":true,"description":"Stable supplier record ID in the token’s Space, up to 200 characters. Encode it as one path segment.","schema":{"type":"string"},"example":"supplier-001"}],"responses":{"200":{"description":"The current plan and recent case metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["plan","cases","deliveryAvailable"],"properties":{"plan":{"type":["object","null"],"oneOf":[{"$ref":"#/components/schemas/DeveloperSupplierDeliveryPlan"},{"type":"null"}]},"cases":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperSupplierDeliveryCase"},"maxItems":50},"deliveryAvailable":{"type":"boolean"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid identifier, query, action or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The operation requires an eligible Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required grant, or the plan does not permit the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The API, Compliance, supplier, delivery case or clean evidence is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The Developer request budget or supplier delivery receipt limit is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Supplier delivery is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperSupplierDelivery","summary":"Read a supplier delivery plan and recent cases","description":"Returns the saved schedule and the 50 most recent delivery cases. deliveryAvailable describes whether current paid email dispatch is configured. Recipients, respondent answers and delivery credentials are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:supplier-delivery:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{supplierId}/delivery/{caseId}":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"supplierId","required":true,"description":"Stable supplier record ID in the token’s Space, up to 200 characters. Encode it as one path segment.","schema":{"type":"string"},"example":"supplier-001"},{"in":"path","name":"caseId","required":true,"description":"Delivery case UUID for the selected supplier.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The authorized delivery case summary.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperSupplierDeliveryCase"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid identifier, query, action or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The operation requires an eligible Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required grant, or the plan does not permit the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The API, Compliance, supplier, delivery case or clean evidence is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The Developer request budget or supplier delivery receipt limit is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Supplier delivery is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getDeveloperSupplierDeliveryCase","summary":"Read a supplier delivery case","description":"Returns the case state, optimistic version and aggregate submission and email counts for this supplier. The case can be older than the recent cases shown in the overview.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:supplier-delivery:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{supplierId}/delivery/{caseId}/evidence":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"supplierId","required":true,"description":"Stable supplier record ID in the token’s Space, up to 200 characters. Encode it as one path segment.","schema":{"type":"string"},"example":"supplier-001"},{"in":"path","name":"caseId","required":true,"description":"Delivery case UUID for the selected supplier.","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"limit","description":"Maximum files per page. Defaults to 20.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"in":"query","name":"cursor","description":"The previous page’s nextCursor for this case.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The authorized evidence metadata page.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["files","pagination"],"properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperSupplierDeliveryEvidence"},"maxItems":100},"pagination":{"type":"object","additionalProperties":false,"required":["limit","nextCursor"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"nextCursor":{"type":["string","null"],"format":"uuid"}}}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid identifier, query, action or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The operation requires an eligible Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required grant, or the plan does not permit the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The API, Compliance, supplier, delivery case or clean evidence is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The Developer request budget or supplier delivery receipt limit is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Supplier delivery is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listDeveloperSupplierDeliveryEvidence","summary":"List clean submitted supplier evidence","description":"Returns one page of submitted, scan-clean evidence metadata in stable file ID order. Use nextCursor with the same case to continue.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:supplier-delivery:evidence:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{supplierId}/delivery/{caseId}/evidence/{fileId}":{"get":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"supplierId","required":true,"description":"Stable supplier record ID in the token’s Space, up to 200 characters. Encode it as one path segment.","schema":{"type":"string"},"example":"supplier-001"},{"in":"path","name":"caseId","required":true,"description":"Delivery case UUID for the selected supplier.","schema":{"type":"string","format":"uuid"}},{"in":"path","name":"fileId","required":true,"description":"File UUID from the clean submitted evidence list.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Audited evidence attachment, streamed through the App.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Content-Disposition":{"description":"Attachment with the encoded original filename.","schema":{"type":"string"}},"Content-Length":{"description":"Exact file byte length.","schema":{"type":"integer","minimum":1,"maximum":5000000}}}},"400":{"description":"Invalid identifier, query, action or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The operation requires an eligible Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required grant, or the plan does not permit the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The API, Compliance, supplier, delivery case or clean evidence is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The Developer request budget or supplier delivery receipt limit is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Supplier delivery is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"downloadDeveloperSupplierDeliveryEvidence","summary":"Download clean submitted supplier evidence","description":"Downloads an existing clean file from this case through the App. An audit entry is required before any bytes are released. Files are limited to 5 MB and returned as uncached attachments.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:supplier-delivery:evidence:read"],"x-rate-limit":{"requestCredits":10,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"file_transfer","windowSeconds":3600,"tokenRequests":24,"spaceRequests":60}}}},"/api/v1/compliance/suppliers/{supplierId}/delivery/actions":{"post":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"supplierId","required":true,"description":"Stable supplier record ID in the token’s Space, up to 200 characters. Encode it as one path segment.","schema":{"type":"string"},"example":"supplier-001"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Use 16 to 128 ASCII letters, digits, underscores or hyphens. Reuse the same key for the same supplier and action when retrying.","schema":{"type":"string"},"example":"61d9263e-143b-4407-90fd-e3b54df67c96"}],"responses":{"200":{"description":"A committed action or an exact seven-day receipt replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperSupplierDeliveryReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Idempotency-Replayed":{"description":"Present as true for an exact retry.","schema":{"type":"string","const":"true"}}}},"400":{"description":"Invalid identifier, query, action or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The operation requires an eligible Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required grant, or the plan does not permit the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The API, Compliance, supplier, delivery case or clean evidence is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The key was used for another request, the saved recipient changed, or the current case state or version prevents the action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 32 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The Developer request budget or supplier delivery receipt limit is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Supplier delivery is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"changeDeveloperSupplierDelivery","summary":"Pause or review supplier questionnaire delivery","description":"Pauses a plan or applies a versioned review, revocation or closure to a case. Approval requires clean submitted evidence. The mutation, replay receipt and audit record commit together.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:supplier-delivery:write"],"requestBody":{"required":true,"description":"Send one action as an application/json body of up to 32 KiB.","content":{"application/json":{"schema":{"type":"object","oneOf":[{"title":"Pause the plan","type":"object","additionalProperties":false,"required":["action"],"properties":{"action":{"type":"string","const":"pause"}}},{"title":"Review the latest submission","type":"object","additionalProperties":false,"required":["action","caseId","version","decision","note"],"properties":{"action":{"type":"string","const":"review"},"caseId":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":1,"maximum":2147483647},"decision":{"type":"string","enum":["approved","changes_requested"]},"note":{"type":"string","description":"Up to 10,000 characters. Change requests require a nonblank note."}}},{"title":"Revoke the response link","type":"object","additionalProperties":false,"required":["action","caseId","version"],"properties":{"action":{"type":"string","const":"revoke"},"caseId":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":1,"maximum":2147483647}}},{"title":"Close the case","type":"object","additionalProperties":false,"required":["action","caseId","version"],"properties":{"action":{"type":"string","const":"close"},"caseId":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":1,"maximum":2147483647}}}]},"example":{"action":"pause"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{supplierId}/delivery/send":{"post":{"tags":["Developer Compliance"],"parameters":[{"in":"path","name":"supplierId","required":true,"description":"Stable supplier record ID in the token’s Space, up to 200 characters. Encode it as one path segment.","schema":{"type":"string"},"example":"supplier-001"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Use 16 to 128 ASCII letters, digits, underscores or hyphens. Reuse the same key for the same supplier and action when retrying.","schema":{"type":"string"},"example":"61d9263e-143b-4407-90fd-e3b54df67c96"}],"responses":{"200":{"description":"A committed action or an exact seven-day receipt replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperSupplierDeliveryReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Idempotency-Replayed":{"description":"Present as true for an exact retry.","schema":{"type":"string","const":"true"}}}},"400":{"description":"Invalid identifier, query, action or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"Developer token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The operation requires an eligible Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required grant, or the plan does not permit the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The API, Compliance, supplier, delivery case or clean evidence is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The key was used for another request, the saved recipient changed, or the current case state or version prevents the action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 32 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The Developer request budget or supplier delivery receipt limit is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Supplier delivery is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"queueDeveloperSupplierDelivery","summary":"Schedule or queue supplier questionnaire delivery","description":"Confirms a plan, queues a send for an active Manual plan, or reopens a versioned case. Email targets the saved supplier contact and uses the existing asynchronous dispatcher. Recurrence and reminders require Business or Enterprise. The API returns a receipt for scheduling or queue acceptance.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:supplier-delivery:send"],"requestBody":{"required":true,"description":"Send one action as an application/json body of up to 32 KiB.","content":{"application/json":{"schema":{"type":"object","oneOf":[{"title":"Confirm or schedule a plan","type":"object","additionalProperties":false,"required":["action","sourceCaseId","timeZone","mode","firstSendDate","intervalMonths","responseWindowDays","reminderDays"],"properties":{"action":{"type":"string","const":"confirm"},"sourceCaseId":{"type":"string","description":"Saved Supplier assessment questionnaire ID for this supplier."},"timeZone":{"type":"string","description":"IANA time zone such as Europe/Berlin."},"mode":{"type":"string","enum":["Manual","One-off","Recurring"]},"firstSendDate":{"type":"string","description":"Local YYYY-MM-DD. Use an empty string for Manual plans."},"intervalMonths":{"type":["integer","null"],"description":"Use 1 to 36 for Recurring or null for Manual and One-off."},"responseWindowDays":{"type":"integer","minimum":1,"maximum":365},"reminderDays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":364},"maxItems":5,"description":"Unique offsets strictly before the due date. Leave empty for Manual."}}},{"title":"Send from an active Manual plan","type":"object","additionalProperties":false,"required":["action"],"properties":{"action":{"type":"string","const":"send"}}},{"title":"Reopen a case and queue a new link","type":"object","additionalProperties":false,"required":["action","caseId","version"],"properties":{"action":{"type":"string","const":"reopen"},"caseId":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":1,"maximum":2147483647}}}]},"example":{"action":"confirm","sourceCaseId":"questionnaire-001","timeZone":"Europe/Berlin","mode":"Manual","firstSendDate":"","intervalMonths":null,"responseWindowDays":14,"reminderDays":[]}}}},"x-rate-limit":{"requestCredits":10,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"supplier_delivery","windowSeconds":3600,"tokenRequests":10,"spaceRequests":30}}}},"/api/v1/compliance/training-assignments":{"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceTrainingAssignment"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceTrainingAssignments","summary":"List training assignments","description":"Lists saved training assignments in the token’s Space. Requires an active Compliance entitlement. Includes the assigned course, due date, and completion percentage. Contact identifiers, acknowledgments, and reminder data are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-assignments:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Training"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceTrainingAssignment","summary":"Create a Compliance training assignment","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-assignments:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"contactId":{"type":"string","maxLength":180,"minLength":1},"courseId":{"type":"string","maxLength":180,"minLength":1},"completionProof":{"type":"string","maxLength":1000,"description":"Certificate link or completion reference."},"dueDate":{"type":"string","format":"date"}},"required":["contactId","courseId","dueDate"]},"recordId":{"type":"string","minLength":1,"maxLength":200}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-assignments/{recordId}":{"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceTrainingAssignment"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrainingAssignment","summary":"Get a training assignment","description":"Reads a saved training assignment summary in the token’s Space. Requires an active Compliance entitlement. Includes the assigned course, due date, and completion percentage. Contact identifiers, acknowledgments, and reminder data are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-assignments:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceTrainingAssignment","summary":"Update a Compliance training assignment","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-assignments:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"completionProof":{"type":"string","maxLength":1000,"description":"Certificate link or completion reference."},"dueDate":{"type":"string","format":"date"},"progress":{"type":"integer","minimum":0,"maximum":100}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}},{"in":"query","name":"revision","required":true,"description":"Current workspace revision. Linked records prevent deletion.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceTrainingAssignment","summary":"Delete a Compliance training assignment","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-assignments:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-courses":{"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceTrainingCourse"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceTrainingCourses","summary":"List training courses","description":"Lists saved training courses in the token’s Space. Requires an active Compliance entitlement. Includes the title and duration in minutes. Descriptions and learning material are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-courses:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Training"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceTrainingCourse","summary":"Create a Compliance training course","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-courses:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"title":{"type":"string","maxLength":512,"minLength":1},"description":{"type":"string","maxLength":8000,"minLength":1},"durationMinutes":{"type":"integer","minimum":1,"maximum":1440},"modules":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","maxLength":1000,"minLength":1}}},"required":["title","description","durationMinutes","modules"]},"recordId":{"type":"string","minLength":1,"maxLength":200}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-courses/{recordId}":{"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceTrainingCourse"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrainingCourse","summary":"Get a training course","description":"Reads a saved training course summary in the token’s Space. Requires an active Compliance entitlement. Includes the title and duration in minutes. Descriptions and learning material are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-courses:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceTrainingCourse","summary":"Update a Compliance training course","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-courses:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"title":{"type":"string","maxLength":512,"minLength":1},"description":{"type":"string","maxLength":8000,"minLength":1},"durationMinutes":{"type":"integer","minimum":1,"maximum":1440},"modules":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","maxLength":1000,"minLength":1}}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}},{"in":"query","name":"revision","required":true,"description":"Current workspace revision. Linked records prevent deletion.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceTrainingCourse","summary":"Delete a Compliance training course","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-courses:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-policies/{recordId}":{"delete":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."},{"in":"query","name":"revision","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Current saved Compliance workspace revision."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the record is linked, or the workspace revision limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceTrainingPolicy","summary":"Delete a Compliance training policy","description":"Deletes an unlinked training policy at the supplied workspace revision. References must be removed before the record can be deleted. A successful deletion advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-policies:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceTrainingPolicy"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrainingPolicy","summary":"Get a training policy","description":"Reads a saved training policy summary in the token’s Space. Requires an active Compliance entitlement. Includes the policy ID and title. Policy content and acknowledgment data are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-policies:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID, revision, fields, or references are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body did not arrive within the time limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale or the workspace revision limit was reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The request body exceeds 65,536 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"The request body must be JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceTrainingPolicy","summary":"Update a Compliance training policy","description":"Updates the supplied training policy fields at the current saved workspace revision. Other record data is preserved. An unchanged request returns changed=false. A saved change advances the revision and records a Space audit event.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-policies:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"anyOf":[{"type":"object","required":["title"]},{"type":"object","required":["description"]}],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","minLength":1,"maxLength":512},"description":{"type":"string","minLength":1,"maxLength":8000}}},"example":{"revision":4,"title":"Quarterly access review policy"}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-access-requests":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceTrustAccessRequest"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceTrustAccessRequests","summary":"List Trust Center access requests","description":"Lists saved Trust Center access requests in the token’s Space. Requires an active Compliance entitlement. Includes workflow status and decision timestamps. Requesters, document identifiers, reasons, fingerprints, and reviewer details are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-access-requests:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-access-requests/{recordId}":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceTrustAccessRequest"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrustAccessRequest","summary":"Get a Trust Center access request","description":"Reads a saved Trust Center access request summary in the token’s Space. Requires an active Compliance entitlement. Includes workflow status and decision timestamps. Requesters, document identifiers, reasons, fingerprints, and reviewer details are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-access-requests:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-certifications":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceTrustCertification"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceTrustCertifications","summary":"List Trust Center certifications","description":"Lists saved Trust Center certifications in the token’s Space. Requires an active Compliance entitlement. Includes title, issuer, status, expiry date, and access restriction. Contacts, verification URLs, and internal notes are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-certifications:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Trust Center"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceTrustCertification","summary":"Create a Compliance Trust Center assurance record","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-certifications:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"title":{"type":"string","maxLength":512,"minLength":1},"ownerContactId":{"type":"string","maxLength":180,"minLength":1},"issuer":{"type":"string","maxLength":512},"reference":{"type":"string","maxLength":2000},"expiryDate":{"type":"string","maxLength":10},"notes":{"type":"string","maxLength":8000},"assuranceKind":{"type":"string","enum":["Certification","Attestation report","Self-assessment"]},"standardEdition":{"type":"string","maxLength":512},"issuedOn":{"type":"string","maxLength":10},"verificationUrl":{"type":"string","maxLength":2000},"nextMilestone":{"type":"string","enum":["Define scope and prepare","Internal readiness review","Stage 1 audit","Stage 2 audit","Certification decision","Surveillance audit","Recertification audit","Other follow-up"]},"scope":{"type":"string","maxLength":8000},"nextReviewDate":{"type":"string","maxLength":10},"reportStartDate":{"type":"string","maxLength":10},"reportEndDate":{"type":"string","maxLength":10}},"required":["title","ownerContactId"]},"recordId":{"type":"string","minLength":1,"maxLength":200}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-certifications/{recordId}":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceTrustCertification"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrustCertification","summary":"Get a Trust Center certification","description":"Reads a saved Trust Center certification summary in the token’s Space. Requires an active Compliance entitlement. Includes title, issuer, status, expiry date, and access restriction. Contacts, verification URLs, and internal notes are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-certifications:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceTrustCertification","summary":"Update a Compliance Trust Center assurance record","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-certifications:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"title":{"type":"string","maxLength":512,"minLength":1},"ownerContactId":{"type":"string","maxLength":180,"minLength":1},"issuer":{"type":"string","maxLength":512},"reference":{"type":"string","maxLength":2000},"expiryDate":{"type":"string","maxLength":10},"status":{"type":"string","enum":["Draft","Current","Suspended","Withdrawn","Expired","Verified"]},"notes":{"type":"string","maxLength":8000},"assuranceKind":{"type":"string","enum":["Certification","Attestation report","Self-assessment"]},"standardEdition":{"type":"string","maxLength":512},"issuedOn":{"type":"string","maxLength":10},"verificationUrl":{"type":"string","maxLength":2000},"nextMilestone":{"type":"string","enum":["Define scope and prepare","Internal readiness review","Stage 1 audit","Stage 2 audit","Certification decision","Surveillance audit","Recertification audit","Other follow-up"]},"scope":{"type":"string","maxLength":8000},"nextReviewDate":{"type":"string","maxLength":10},"reportStartDate":{"type":"string","maxLength":10},"reportEndDate":{"type":"string","maxLength":10}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}},{"in":"query","name":"revision","required":true,"description":"Current workspace revision. Linked records prevent deletion.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceTrustCertification","summary":"Delete a Compliance Trust Center assurance record","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-certifications:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-documents":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceTrustDocument"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceTrustDocuments","summary":"List Trust Center documents","description":"Lists saved Trust Center documents in the token’s Space. Requires an active Compliance entitlement. Includes title, access restriction, and last update. Document text, attachments, and download links are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-documents:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Trust Center"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceTrustDocument","summary":"Create a Compliance Trust Center document","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-documents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"title":{"type":"string","maxLength":512,"minLength":1},"description":{"type":"string","maxLength":8000},"content":{"type":"string","maxLength":8000},"ownerContactId":{"type":"string","maxLength":180,"minLength":1}},"required":["title","ownerContactId","content"]},"recordId":{"type":"string","minLength":1,"maxLength":200}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-documents/{recordId}":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceTrustDocument"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrustDocument","summary":"Get a Trust Center document","description":"Reads a saved Trust Center document summary in the token’s Space. Requires an active Compliance entitlement. Includes title, access restriction, and last update. Document text, attachments, and download links are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-documents:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceTrustDocument","summary":"Update a Compliance Trust Center document","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-documents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"title":{"type":"string","maxLength":512,"minLength":1},"description":{"type":"string","maxLength":8000},"content":{"type":"string","maxLength":8000},"ownerContactId":{"type":"string","maxLength":180,"minLength":1}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}},{"in":"query","name":"revision","required":true,"description":"Current workspace revision. Linked records prevent deletion.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceTrustDocument","summary":"Delete a Compliance Trust Center document","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-documents:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-subprocessors":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum records per page."},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque nextCursor from a previous page in this collection."}],"responses":{"200":{"description":"Saved records and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["records","revision","pagination"],"properties":{"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperComplianceTrustSubprocessor"}},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagination":{"$ref":"#/components/schemas/DeveloperCompliancePagination"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The limit or cursor is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The Compliance collection is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The workspace changed. Start a new list request without a cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"listComplianceTrustSubprocessors","summary":"List Trust Center subprocessors","description":"Lists saved Trust Center subprocessors in the token’s Space. Requires an active Compliance entitlement. Includes name, purpose, and region. Contacts and notes are omitted. The cursor is valid only while the workspace revision remains current.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-subprocessors:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"post":{"tags":["Developer Compliance Trust Center"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"createComplianceTrustSubprocessor","summary":"Create a Compliance Trust Center subprocessor","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-subprocessors:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","maxLength":512,"minLength":1},"purpose":{"type":"string","maxLength":2000,"minLength":1},"region":{"type":"string","maxLength":512,"minLength":1},"website":{"type":"string","maxLength":2000},"ownerContactId":{"type":"string","maxLength":180,"minLength":1},"notes":{"type":"string","maxLength":8000}},"required":["name","purpose","region","ownerContactId"]},"recordId":{"type":"string","minLength":1,"maxLength":200}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-subprocessors/{recordId}":{"get":{"tags":["Developer Compliance Trust"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record summary and workspace revision from one snapshot.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceTrustSubprocessor"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"The record ID or query parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"The Space needs an active Compliance entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks the required scope or current Space access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space or Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The Compliance workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrustSubprocessor","summary":"Get a Trust Center subprocessor","description":"Reads a saved Trust Center subprocessor summary in the token’s Space. Requires an active Compliance entitlement. Includes name, purpose, and region. Contacts and notes are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-subprocessors:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The JSON body timed out.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use an application/json body.","headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceTrustSubprocessor","summary":"Update a Compliance Trust Center subprocessor","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-subprocessors:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","maxLength":512,"minLength":1},"purpose":{"type":"string","maxLength":2000,"minLength":1},"region":{"type":"string","maxLength":512,"minLength":1},"website":{"type":"string","maxLength":2000},"ownerContactId":{"type":"string","maxLength":180,"minLength":1},"notes":{"type":"string","maxLength":8000}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}},{"in":"query","name":"revision","required":true,"description":"Current workspace revision. Linked records prevent deletion.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid revision, fields or record relationships.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The token lacks its scope or current Space permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record or Compliance is unavailable in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, the ID conflicts, the record is linked or portal review is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The change could not be confirmed. Refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceTrustSubprocessor","summary":"Delete a Compliance Trust Center subprocessor","description":"Changes one record using the current workspace revision, current Space permissions and active Compliance entitlement. The canonical Portal validators apply. Mutation receipts contain no record contents. Course and assignment changes do not send email. Restricted Trust records stay restricted; public disclosures and attachments require review in Dashio.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-subprocessors:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/workspace":{"get":{"tags":["Developer Compliance Workspace"],"parameters":[],"responses":{"200":{"description":"The saved v1 workspace and its current revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schemaVersion","revision","collections"],"properties":{"schemaVersion":{"type":"integer","const":1},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Optimistic revision used by workspace writes."},"collections":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadCollections"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Unsupported query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Current Space administrator access and the required scope are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The saved workspace exceeds the 8 MB snapshot limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The token or Space request budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The workspace is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"readDeveloperComplianceWorkspace","summary":"Read the Compliance workspace","description":"Returns the 16 Compliance collections at one revision, including the member-backed contact directory and other private Space records. Attachments contain only their reusable metadata. For an oversized workspace, use the individually scoped collection operations.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:workspace:read"],"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}},"put":{"tags":["Developer Compliance Workspace"],"parameters":[],"responses":{"200":{"description":"The committed revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"properties":{"revision":{"type":"integer","minimum":1,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid body, collection, workflow transition or relationship.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Space administration, scope or entitlement limits prevent the write.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"Compliance is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"408":{"description":"The request body timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision, upload reservation or a record ID conflicts with current state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The body, saved workspace or uploads exceed the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"415":{"description":"Use application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The Space or token request or upload budget is exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The write could not be confirmed. Read the current revision before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"saveDeveloperComplianceWorkspace","summary":"Save a Compliance workspace revision","description":"Saves editable collections at the supplied revision. Start with the current workspace and preserve unchanged records. The read-only contacts collection comes from Space members. The same history, relationship and entitlement checks apply as in the Portal. JSON is limited to 20 MB and saved metadata to 8 MB. Upload up to 20 files, each at most 1 MB, up to 15 MB total. A successful write returns only the new revision.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:workspace:write"],"x-conditional-scopes":{"compliance:evidence:write":"Required to change, add, or remove an attachment.","compliance:trust-access-requests:approve":"Required to approve a Trust Center disclosure."},"requestBody":{"required":true,"description":"The current revision and all 16 collections, including unchanged records.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","collections"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740990},"collections":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteCollections"}}}}}},"x-rate-limit":{"requestCredits":12,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60},"hourly":{"group":"compliance_bulk","windowSeconds":3600,"tokenRequests":15,"spaceRequests":40}}}},"/api/v1/compliance/controls/{controlId}/details":{"get":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"controlId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record and revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","record"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadControl"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceControlDetails","summary":"Read control details","description":"Reads the saved record content and current revision in the token’s Space. File bodies, storage locators and disclosure proofs are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:controls:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"controlId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceControlDetails","summary":"Update Compliance control","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:controls:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"description":{"type":"string"},"ownerContactId":{"type":"string"},"frameworks":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"dueDate":{"type":"string"},"requirementMappings":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteControlRequirementMapping"}}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/risks/{riskId}/details":{"get":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"riskId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record and revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","record"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadRiskRecord"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceRiskDetails","summary":"Read risk details","description":"Reads the saved record content and current revision in the token’s Space. File bodies, storage locators and disclosure proofs are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:risks:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"patch":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"riskId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceRiskDetails","summary":"Update Compliance risk","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:risks:manage"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"description":{"type":"string"},"ownerContactId":{"type":"string"},"category":{"type":"string"},"likelihood":{"type":"number"},"impact":{"type":"number"},"residual":{"type":"number"},"status":{"type":"string"},"treatment":{"type":"string"},"dueDate":{"type":"string"},"actions":{"type":"array","items":{"type":"string"}},"completedActions":{"type":"array","items":{"type":"string"}},"controls":{"type":"array","items":{"type":"string"}}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{recordId}/details":{"get":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record and revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","record"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadSupplierRecord"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceSupplierDetails","summary":"Read supplier details","description":"Reads the saved record content and current revision in the token’s Space. File bodies, storage locators and disclosure proofs are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:suppliers:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/questionnaires/{recordId}/details":{"get":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record and revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","record"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireCase"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceQuestionnaireContent","summary":"Read questionnaire details","description":"Reads the saved record content and current revision in the token’s Space. File bodies, storage locators and disclosure proofs are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaires:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/questionnaire-answers/{recordId}/details":{"get":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record and revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","record"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireAnswer"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceQuestionnaireAnswerContent","summary":"Read reusable questionnaire answer details","description":"Reads the saved record content and current revision in the token’s Space. File bodies, storage locators and disclosure proofs are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaire-answers:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/evidence/{evidenceId}/details":{"get":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"evidenceId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Saved record and revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","record"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadEvidence"}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceEvidenceDetails","summary":"Read evidence details","description":"Reads the saved record content and current revision in the token’s Space. File bodies, storage locators and disclosure proofs are excluded.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:evidence:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/suppliers/{recordId}/assessment":{"patch":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceSupplierAssessment","summary":"Update Compliance supplier","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:suppliers:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"assessmentChecks":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSupplierAssessmentCheck"}},"documents":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSupplierDocument"}},"notes":{"type":"string"},"review":{"type":"string"},"linkedRiskIds":{"type":"array","items":{"type":"string"}}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/evidence/{evidenceId}":{"patch":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"evidenceId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"updateComplianceEvidence","summary":"Update Compliance evidence","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:evidence:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"controlId":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"description":{"type":"string"},"sourceUrl":{"type":"string"},"evidenceKind":{"type":"string","enum":["Period-based","Point-in-time","Standing document"]},"collectedOn":{"type":"string"},"coverageStart":{"type":"string"},"coverageEnd":{"type":"string"},"renewalDate":{"type":"string"},"sourceSystem":{"type":"string"},"acceptanceCriteria":{"type":"string"},"additionalControlIds":{"type":"array","items":{"type":"string"}}}}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}},"delete":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"evidenceId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."},{"in":"query","name":"revision","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"deleteComplianceEvidence","summary":"Delete Compliance evidence","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:evidence:write"],"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-courses/{recordId}/details":{"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Saved record and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrainingCourse"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record ID or query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope and current Space permission are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record exceeds the bounded content response. Review it in Dashio.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The record is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrainingCourseDetails","summary":"Read full Compliance training course details","description":"Returns one record and its current workspace revision under the collection read scope. Includes saved content and references. File bytes, storage locators and disclosure approval proofs are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-courses:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-assignments/{recordId}/details":{"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Saved record and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrainingAssignment"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record ID or query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope and current Space permission are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record exceeds the bounded content response. Review it in Dashio.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The record is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrainingAssignmentDetails","summary":"Read full Compliance training assignment details","description":"Returns one record and its current workspace revision under the collection read scope. Includes saved content and references. File bytes, storage locators and disclosure approval proofs are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-assignments:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/training-policies/{recordId}/details":{"get":{"tags":["Developer Compliance Training"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Saved record and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrainingPolicy"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record ID or query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope and current Space permission are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record exceeds the bounded content response. Review it in Dashio.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The record is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrainingPolicyDetails","summary":"Read full Compliance training policy details","description":"Returns one record and its current workspace revision under the collection read scope. Includes saved content and references. File bytes, storage locators and disclosure approval proofs are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:training-policies:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-certifications/{recordId}/details":{"get":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Saved record and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrustCertification"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record ID or query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope and current Space permission are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record exceeds the bounded content response. Review it in Dashio.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The record is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrustCertificationDetails","summary":"Read full Compliance Trust Center assurance record details","description":"Returns one record and its current workspace revision under the collection read scope. Includes saved content and references. File bytes, storage locators and disclosure approval proofs are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-certifications:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-documents/{recordId}/details":{"get":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Saved record and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrustDocument"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record ID or query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope and current Space permission are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record exceeds the bounded content response. Review it in Dashio.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The record is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrustDocumentDetails","summary":"Read full Compliance Trust Center security document details","description":"Returns one record and its current workspace revision under the collection read scope. Includes saved content and references. File bytes, storage locators and disclosure approval proofs are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-documents:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/trust-subprocessors/{recordId}/details":{"get":{"tags":["Developer Compliance Trust Center"],"parameters":[{"in":"path","name":"recordId","required":true,"description":"Saved record ID encoded as one path segment.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Saved record and current workspace revision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["record","revision"],"properties":{"record":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrustSubprocessor"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record ID or query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope and current Space permission are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record exceeds the bounded content response. Review it in Dashio.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The record is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"getComplianceTrustSubprocessorDetails","summary":"Read full Compliance Trust Center subprocessor details","description":"Returns one record and its current workspace revision under the collection read scope. Includes saved content and references. File bytes, storage locators and disclosure approval proofs are omitted.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:trust-subprocessors:read"],"x-rate-limit":{"requestCredits":1,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/evidence/requests":{"post":{"tags":["Developer Compliance Workflows"],"parameters":[],"responses":{"201":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"requestComplianceEvidence","summary":"Request Compliance evidence","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:evidence:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","changes","recordId"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"controlId":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"description":{"type":"string"},"evidenceKind":{"type":"string","enum":["Period-based","Point-in-time","Standing document"]},"collectedOn":{"type":"string"},"coverageStart":{"type":"string"},"coverageEnd":{"type":"string"},"renewalDate":{"type":"string"},"sourceSystem":{"type":"string"},"acceptanceCriteria":{"type":"string"},"additionalControlIds":{"type":"array","items":{"type":"string"}}}},"recordId":{"type":"string","minLength":1,"maxLength":180}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}},"/api/v1/compliance/questionnaires/{recordId}/submit-review":{"post":{"tags":["Developer Compliance Workflows"],"parameters":[{"in":"path","name":"recordId","required":true,"schema":{"type":"string","minLength":1,"maxLength":180},"description":"Saved record ID, URL-encoded as one path segment."}],"responses":{"200":{"description":"Record change receipt and resulting workspace revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperComplianceMutationReceipt"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid record, revision, fields or references.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"401":{"description":"A valid developer token is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. A rejected token can include the invalid_token error.","schema":{"type":"string"}}}},"402":{"description":"An active Compliance entitlement is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"The required scope or current Space or product permissions are missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"404":{"description":"The record was not found in this Space.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"409":{"description":"The revision is stale, a reference blocks deletion or the lifecycle change is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"413":{"description":"The record or request exceeds the permitted size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}},"429":{"description":"The request budget was exhausted. Edge traffic limits can also return 429.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}},"RateLimit-Limit":{"description":"Per-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Unix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying, when the limiting policy supplies a retry time.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"The operation could not be confirmed. Read the current record before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApiError"}}},"headers":{"X-Request-Id":{"description":"Server-generated ID to include in a support request.","schema":{"type":"string","format":"uuid"}}}}},"operationId":"submitComplianceQuestionnaireForReview","summary":"Submit a questionnaire for internal review","description":"Changes one record in the token’s Space after current product permission, entitlement, revision, reference and lifecycle checks. Private file references and review history are preserved. No external messages are sent.","security":[{"developerToken":[]}],"x-required-scopes":["compliance:questionnaires:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision"],"properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}}},"x-rate-limit":{"requestCredits":3,"minute":{"tokenCredits":60,"spaceCredits":300,"windowSeconds":60}}}}},"components":{"securitySchemes":{"developerToken":{"type":"http","scheme":"bearer","description":"A Space-bound opaque Dashio developer token. Send it only in the Authorization header as Bearer credentials. Each operation lists its independent required grant."}},"schemas":{"DeveloperApiError":{"type":"object","required":["statusCode","data"],"properties":{"statusCode":{"type":"integer","minimum":400,"maximum":599},"statusMessage":{"type":"string","description":"A safe explanation suitable for display."},"data":{"type":"object","required":["code","requestId"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"requestId":{"type":"string","format":"uuid","description":"Server-generated ID for troubleshooting."}}}}},"DeveloperDomainPagination":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"nextCursor":{"type":["string","null"],"format":"uuid","description":"Send as cursor on the next request. Null identifies the last page."}}},"DeveloperDomain":{"type":"object","required":["id","name","status","createdAt","expiresAt"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","description":"Registered domain in lowercase ASCII or punycode."},"status":{"type":["string","null"],"description":"Current recorded registration status, when available."},"createdAt":{"type":["string","null"],"format":"date-time","description":"When Dashio created the inventory record, when available."},"expiresAt":{"type":["string","null"],"format":"date-time","description":"Recorded registration expiry, when available."}}},"DeveloperDnsRecord":{"type":"object","additionalProperties":false,"required":["id","type","name","value","ttl","priority"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","description":"DNS resource record type, such as A, TXT, or MX."},"name":{"type":"string","description":"Record owner name, relative to the domain. @ denotes the zone apex."},"value":{"type":"string","description":"Record data as stored for its DNS type."},"ttl":{"type":["integer","null"],"description":"Stored time to live in seconds, or null when it has not been recorded."},"priority":{"type":["integer","null"],"description":"Priority for record types that define one."}}},"DeveloperDomainAuditRequestReceipt":{"type":"object","additionalProperties":false,"required":["audit","replayed"],"properties":{"audit":{"$ref":"#/components/schemas/DeveloperDomainAudit"},"replayed":{"type":"boolean","description":"True for a replay of the original acceptance receipt."}}},"DeveloperDomainAudit":{"type":"object","additionalProperties":false,"required":["auditId","domain","status","requestedAt","startedAt","finishedAt"],"properties":{"auditId":{"type":"string","format":"uuid"},"domain":{"type":"string","description":"Registered domain in lowercase ASCII or punycode."},"status":{"type":"string","enum":["queued","running","completed","partial","failed"]},"requestedAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"}}},"DeveloperDnsRecordValidationError":{"type":"object","required":["statusCode","data"],"properties":{"statusCode":{"type":"integer","const":400},"statusMessage":{"type":"string"},"data":{"type":"object","required":["code","requestId"],"properties":{"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"fields":{"type":"object","additionalProperties":{"type":"string"},"description":"Optional field-specific validation guidance."}}}}},"DeveloperDnsRecordMutationRequest":{"type":"object","additionalProperties":false,"required":["record"],"properties":{"record":{"type":"object","additionalProperties":false,"required":["type","name","value","ttl"],"properties":{"type":{"type":"string","enum":["A","AAAA","CNAME","MX","TXT","CAA"],"description":"Record type writable by this API."},"name":{"type":"string","minLength":1,"maxLength":253,"description":"Relative owner name. Use @ for the apex or * for a wildcard. CNAME cannot use the apex. The complete owner and domain must fit in 253 characters."},"value":{"type":"string","minLength":1,"maxLength":4000,"description":"Type-specific data, at most 4000 UTF-8 bytes. A and AAAA require public addresses. CNAME and MX accept hostnames. Null MX uses . and priority 0. CAA accepts flags 0 or 128 and a supported quoted property."},"ttl":{"type":"integer","minimum":60,"maximum":86400,"description":"Time to live in seconds."},"priority":{"type":["integer","null"],"minimum":0,"maximum":65535,"description":"Required for MX. Use null or omit for other record types."}},"allOf":[{"type":"object","if":{"properties":{"type":{"const":"MX"}},"required":["type"]},"then":{"required":["priority"],"properties":{"priority":{"type":"integer","minimum":0,"maximum":65535}}},"else":{"properties":{"priority":{"type":"null"}}}}]}}},"DeveloperComplianceControl":{"type":"object","required":["id","title","status","frameworks"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Stable control ID."},"title":{"type":"string","description":"Saved control title, shortened to 512 characters when longer."},"status":{"type":"string","description":"Saved status label, shortened to 80 characters when longer."},"frameworks":{"type":"array","maxItems":20,"items":{"type":"string","description":"Framework label, shortened to 120 characters when longer."}}}},"DeveloperCompliancePagination":{"type":"object","required":["limit","nextCursor"],"additionalProperties":false,"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, or null for the last page."}}},"DeveloperComplianceRisk":{"type":"object","additionalProperties":false,"required":["id","title","status","category","treatment","likelihood","impact","inherentScore","residualScore"],"properties":{"id":{"type":"string","description":"Stable risk ID."},"title":{"type":"string","description":"Saved risk title, shortened to 512 characters when longer."},"status":{"type":"string","description":"Saved status label, shortened to 80 characters when longer."},"category":{"type":"string","description":"Saved risk category, shortened to 120 characters when longer."},"treatment":{"type":"string","description":"Saved treatment label, shortened to 80 characters when longer."},"likelihood":{"type":"number","description":"Saved likelihood assessment."},"impact":{"type":"number","description":"Saved impact assessment."},"inherentScore":{"type":"number","description":"Saved inherent risk score."},"residualScore":{"type":"number","description":"Saved residual risk score."}}},"DeveloperComplianceSupplier":{"type":"object","additionalProperties":false,"required":["id","name","category","criticality","risk","assessment"],"properties":{"id":{"type":"string","maxLength":200,"description":"Stable supplier ID."},"name":{"type":"string","maxLength":512,"description":"Saved supplier name."},"category":{"type":"string","maxLength":120,"description":"Saved supplier category."},"criticality":{"type":"string","maxLength":80,"description":"Saved supplier criticality label."},"risk":{"type":"string","maxLength":80,"description":"Saved supplier risk label."},"assessment":{"type":"string","maxLength":120,"description":"Saved supplier assessment label."}}},"DeveloperComplianceTrainingPolicy":{"type":"object","additionalProperties":false,"required":["id","title"],"properties":{"id":{"type":"string","maxLength":200,"description":"Stable training policy ID."},"title":{"type":"string","maxLength":512,"description":"Saved policy title."}}},"DeveloperMarketingSignatureSummary":{"type":"object","additionalProperties":false,"required":["id","name","slug","revision","publishedAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid","description":"Stable generator identifier."},"name":{"type":"string","description":"Display name."},"slug":{"type":"string","description":"The employee page address segment."},"revision":{"type":"integer","minimum":1,"description":"Current optimistic draft revision."},"publishedAt":{"type":["string","null"],"format":"date-time","description":"Time of last publication, or null for an unpublished signature."},"updatedAt":{"type":"string","format":"date-time"}}},"DeveloperMarketingSignatureDraftResponse":{"type":"object","additionalProperties":false,"required":["signature"],"properties":{"signature":{"type":"object","additionalProperties":false,"required":["id","name","slug","revision","publishedAt","updatedAt","draftConfig"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"revision":{"type":"integer","minimum":1,"description":"Use this revision to replace the draft."},"publishedAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"draftConfig":{"$ref":"#/components/schemas/MarketingSignatureConfig"}}}}},"MarketingSignatureConfig":{"type":"object","additionalProperties":false,"required":["version","locales","defaultLocale","company","locations","fields","logos","banners","branding"],"properties":{"version":{"type":"integer","const":1},"locales":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","label"],"properties":{"code":{"type":"string","description":"Use a language code such as en, de or en-GB."},"label":{"type":"string","description":"Length must be 1 to 80 characters."}}},"minItems":1,"maxItems":20},"defaultLocale":{"type":"string","description":"Language code from locales. Use a language code such as en, de or en-GB."},"company":{"type":"object","additionalProperties":false,"required":["name","website","legalText","socialLinks"],"properties":{"name":{"type":"string","description":"Length must be 1 to 180 characters."},"website":{"type":"string","description":"Public HTTPS address or an empty string."},"closingPhrase":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 300 characters."},"description":"Maximum 20 entries."},"legalText":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 8000 characters."},"description":"Maximum 20 entries."},"socialLinks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label","url"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"label":{"type":"string","description":"Length must be 1 to 80 characters."},"url":{"type":"string","format":"uri","description":"Use a public HTTPS URL."}}},"maxItems":20}}},"locations":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name","country","addressLines","legalText","socialLinks"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"name":{"type":"string","description":"Length must be 1 to 120 characters."},"country":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string","description":"Maximum 180 characters."},"maxItems":8,"description":"New and edited locations allow up to four address lines of 120 characters. Stored legacy locations may contain up to eight lines."},"legalText":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 8000 characters."},"description":"Maximum 20 entries."},"socialLinks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label","url"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"label":{"type":"string","description":"Length must be 1 to 80 characters."},"url":{"type":"string","format":"uri","description":"Use a public HTTPS URL."}}},"maxItems":20}}},"maxItems":100},"fields":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","type","label","required","options"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"type":{"type":"string","enum":["text","email","tel","url","select"]},"label":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 100 characters."},"description":"Maximum 20 entries."},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["value","label"],"properties":{"value":{"type":"string","description":"Length must be 1 to 100 characters."},"label":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 100 characters."},"description":"Maximum 20 entries."}}},"maxItems":50},"showLabel":{"type":"boolean"},"placeholder":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 200 characters."},"description":"Maximum 20 entries."}}},"minItems":1,"maxItems":30},"logos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label","url","alt","href","width","height"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"label":{"type":"string","description":"Length must be 1 to 120 characters."},"url":{"type":"string","format":"uri","description":"An embedded PNG, JPEG or GIF up to 128 KiB, or a supported legacy public HTTPS image."},"alt":{"type":"string","description":"Length must be 1 to 200 characters."},"href":{"type":"string","description":"Public HTTPS link or an empty string."},"width":{"type":"integer","minimum":1,"maximum":600},"height":{"type":"integer","minimum":1,"maximum":600}}},"maxItems":20},"banners":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label","url","alt","href","width","height","startsAt","endsAt","isDefault","locationIds","localeCodes"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"label":{"type":"string","description":"Length must be 1 to 120 characters."},"url":{"type":"string","format":"uri","description":"An embedded PNG, JPEG or GIF up to 128 KiB, or a supported legacy public HTTPS image."},"alt":{"type":"string","description":"Length must be 1 to 200 characters."},"href":{"type":"string","description":"Public HTTPS link or an empty string."},"width":{"type":"integer","minimum":1,"maximum":600},"height":{"type":"integer","minimum":1,"maximum":600},"startsAt":{"$ref":"#/components/schemas/DeveloperMarketingBannerTimestamp"},"endsAt":{"$ref":"#/components/schemas/DeveloperMarketingBannerTimestamp"},"isDefault":{"type":"boolean"},"locationIds":{"type":"array","items":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"maxItems":100},"localeCodes":{"type":"array","items":{"type":"string","description":"Use a language code such as en, de or en-GB."},"maxItems":20}}},"maxItems":100},"branding":{"type":"object","additionalProperties":false,"required":["primaryColor","showDashioBranding"],"properties":{"primaryColor":{"type":"string","description":"Three- or six-digit hexadecimal color with an optional leading #."},"showDashioBranding":{"type":"boolean","description":"Legacy compatibility flag. Current signatures render no Dashio branding footer."},"fontFamily":{"type":"string","enum":["arial","calibri","aptos","verdana","tahoma","georgia","times-new-roman","trebuchet-ms"]},"googleFont":{"type":"string","description":"Maximum 80 characters."},"fontSize":{"type":"integer","minimum":10,"maximum":20},"lineHeight":{"type":"integer","minimum":12,"maximum":36}}},"contentOrder":{"type":"array","items":{"type":"string","description":"Use a built-in block key or an existing field:<id> or custom:<id> key."},"maxItems":58,"description":"Include each item at most once."},"design":{"type":"object","additionalProperties":false,"required":["layout","width","gap","primaryWidth","divider","padding","blocks","customBlocks"],"properties":{"layout":{"type":"string","enum":["stacked","columns"]},"width":{"type":"integer","minimum":280,"maximum":640},"gap":{"type":"integer","minimum":0,"maximum":40},"primaryWidth":{"type":"integer","minimum":20,"maximum":80},"divider":{"type":"boolean"},"dividerColor":{"type":"string","description":"Three- or six-digit hexadecimal color with an optional leading #."},"accentColor":{"type":"string","description":"Three- or six-digit hexadecimal color with an optional leading #."},"backgroundColor":{"type":"string","description":"Three- or six-digit hexadecimal color with an optional leading #."},"padding":{"type":"integer","minimum":0,"maximum":32},"blocks":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"required":["zone"],"properties":{"zone":{"type":"string","enum":["header","primary","secondary","footer"]},"hidden":{"type":"boolean"},"align":{"type":"string","enum":["left","center","right"]},"fontSize":{"type":"integer"},"lineHeight":{"type":"integer"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"color":{"type":"string","description":"Three- or six-digit hexadecimal color with an optional leading #."},"backgroundColor":{"type":"string","description":"Three- or six-digit hexadecimal color with an optional leading #."},"padding":{"type":"integer"},"spaceAbove":{"type":"integer"},"spaceBelow":{"type":"integer"},"borderColor":{"type":"string","description":"Three- or six-digit hexadecimal color with an optional leading #."},"borderWidth":{"type":"integer"}}},"description":"Maximum 58 entries."},"customBlocks":{"type":"array","items":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","type","content"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"type":{"type":"string","const":"text"},"content":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 2000 characters."},"description":"Maximum 20 entries."},"richContent":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"href":{"type":"string","format":"uri"}}},"maxItems":200},"description":"Maximum 20 entries."}}},{"type":"object","additionalProperties":false,"required":["id","type","content","href"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"type":{"type":"string","const":"button"},"content":{"type":"object","additionalProperties":{"type":"string","description":"Maximum 2000 characters."},"description":"Maximum 20 entries."},"href":{"type":"string","format":"uri"}}},{"type":"object","additionalProperties":false,"required":["id","type"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"type":{"type":"string","const":"divider"}}},{"type":"object","additionalProperties":false,"required":["id","type","height"],"properties":{"id":{"type":"string","description":"Use 1 to 64 lowercase letters, digits, hyphens or underscores, starting with a letter or digit."},"type":{"type":"string","const":"spacer"},"height":{"type":"integer","minimum":0,"maximum":48}}}],"type":"object"},"maxItems":20}}}},"description":"Version 1 company and field configuration, up to 1.5 MiB of serialized JSON. Employee-entered field values are absent."},"DeveloperMarketingBannerTimestamp":{"type":["string","null"],"pattern":"^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d{1,3})?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$","description":"Use a real calendar date and a time with Z or a numeric offset, or null to leave the campaign boundary open. Seconds are optional and may include up to three fractional digits. An end instant must be after the start."},"DeveloperMarketingSignatureConfigInput":{"type":"object","allOf":[{"$ref":"#/components/schemas/MarketingSignatureConfig"},{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"addressLines":{"type":"array","maxItems":4,"items":{"type":"string","description":"At most 120 characters per address line."}}}}}}}]},"DeveloperMarketingSignatureChanges":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"companyName":{"type":"string","minLength":1,"maxLength":180},"website":{"type":"string","maxLength":2048,"description":"HTTPS website URL, or empty to clear."},"primaryColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"fontFamily":{"type":"string","enum":["arial","calibri","aptos","verdana","tahoma","georgia","times-new-roman","trebuchet-ms"]},"fontSize":{"type":"integer","minimum":10,"maximum":20},"lineHeight":{"type":"integer","minimum":12,"maximum":36,"description":"At least as large as the font size."},"locations":{"type":"array","minItems":1,"maxItems":5,"description":"Changes offices by existing ID.","items":{"type":"object","additionalProperties":false,"minProperties":2,"required":["id"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","minLength":1,"maxLength":120},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"addressLines":{"type":"array","maxItems":4,"items":{"type":"string","minLength":1,"maxLength":120}}}}},"fields":{"type":"array","minItems":1,"maxItems":10,"description":"Changes required status and label visibility by existing contact-field ID.","items":{"type":"object","additionalProperties":false,"minProperties":2,"required":["id"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"required":{"type":"boolean"},"showLabel":{"type":"boolean"}}}}}},"DeveloperBrandProfile":{"type":"object","additionalProperties":false,"required":["id","name","description","guidelines","isDefault","colors","typography","additionalColors","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"guidelines":{"type":"string"},"isDefault":{"type":"boolean"},"colors":{"type":"object","additionalProperties":false,"required":["primary","secondary","accent"],"properties":{"primary":{"type":"string"},"secondary":{"type":"string"},"accent":{"type":"string"}}},"typography":{"type":"object","additionalProperties":false,"required":["headingFamily","bodyFamily","headingWeight","bodyWeight","notes"],"properties":{"headingFamily":{"type":"string"},"bodyFamily":{"type":"string"},"notes":{"type":"string"},"headingWeight":{"type":"integer","minimum":100,"maximum":900},"bodyWeight":{"type":"integer","minimum":100,"maximum":900}}},"additionalColors":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["id","name","hex"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"hex":{"type":"string"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"DeveloperBrandAsset":{"type":"object","additionalProperties":false,"required":["id","brandId","name","variant","mimeType","width","height","byteSize","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"brandId":{"type":"string","format":"uuid"},"name":{"type":"string"},"variant":{"type":"string","enum":["light","dark","mark","other"]},"mimeType":{"type":"string","enum":["image/png","image/jpeg","image/webp"]},"width":{"type":"integer","minimum":1,"maximum":4096},"height":{"type":"integer","minimum":1,"maximum":4096},"byteSize":{"type":"integer","minimum":1},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"DeveloperUtmPage":{"type":"object","oneOf":[{"title":"Campaigns","type":"object","additionalProperties":false,"required":["collection","records","naming","pagination"],"properties":{"collection":{"type":"string","const":"campaigns"},"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperUtmCampaign"}},"naming":{"$ref":"#/components/schemas/DeveloperUtmNaming"},"pagination":{"$ref":"#/components/schemas/DeveloperUtmPagination"}}},{"title":"Links","type":"object","additionalProperties":false,"required":["collection","records","naming","pagination"],"properties":{"collection":{"type":"string","const":"links"},"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperUtmLink"}},"naming":{"$ref":"#/components/schemas/DeveloperUtmNaming"},"pagination":{"$ref":"#/components/schemas/DeveloperUtmPagination"}}},{"title":"Custom presets","type":"object","additionalProperties":false,"required":["collection","records","naming","pagination"],"properties":{"collection":{"type":"string","const":"presets"},"records":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/DeveloperUtmPreset"}},"naming":{"$ref":"#/components/schemas/DeveloperUtmNaming"},"pagination":{"$ref":"#/components/schemas/DeveloperUtmPagination"}}}]},"DeveloperUtmCampaign":{"type":"object","additionalProperties":false,"required":["id","name","description","status","defaults","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"defaults":{"$ref":"#/components/schemas/DeveloperUtmCampaignDefaults"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"DeveloperUtmCampaignDefaults":{"type":"object","additionalProperties":false,"required":["source","medium","campaign"],"properties":{"source":{"type":"string"},"medium":{"type":"string"},"campaign":{"type":"string"}}},"DeveloperUtmNaming":{"type":"object","additionalProperties":false,"required":["lowercase","trimWhitespace","spaceReplacement","stripSpecialCharacters"],"properties":{"lowercase":{"type":"boolean"},"trimWhitespace":{"type":"boolean"},"spaceReplacement":{"type":"string","enum":["underscore","hyphen","keep"]},"stripSpecialCharacters":{"type":"boolean"}}},"DeveloperUtmPagination":{"type":"object","additionalProperties":false,"required":["limit","nextCursor"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"nextCursor":{"type":["string","null"],"maxLength":800,"description":"Continuation bound to the Space, collection and filters for filtered pages. UUID for unfiltered pages. Null on the final page."}}},"DeveloperUtmLink":{"type":"object","additionalProperties":false,"required":["id","campaignId","label","destinationUrl","parameters","generatedUrl","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"campaignId":{"type":"string","format":"uuid"},"label":{"type":"string"},"destinationUrl":{"type":"string","format":"uri"},"generatedUrl":{"type":"string","format":"uri"},"parameters":{"$ref":"#/components/schemas/DeveloperUtmSavedParameters"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"DeveloperUtmSavedParameters":{"type":"object","additionalProperties":false,"required":["source","medium","campaign","term","content"],"properties":{"source":{"type":"string"},"medium":{"type":"string"},"campaign":{"type":"string"},"term":{"type":"string"},"content":{"type":"string"}}},"DeveloperUtmPreset":{"type":"object","additionalProperties":false,"required":["id","name","description","parameters"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string"},"parameters":{"$ref":"#/components/schemas/DeveloperUtmSavedParameters"}}},"DeveloperUtmPartialParameters":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":150},"medium":{"type":"string","maxLength":150},"campaign":{"type":"string","maxLength":150},"term":{"type":"string","maxLength":150},"content":{"type":"string","maxLength":150}}},"DeveloperUtmRequiredParameters":{"type":"object","additionalProperties":false,"required":["source","medium","campaign","term","content"],"properties":{"source":{"type":"string","minLength":1,"maxLength":150},"medium":{"type":"string","minLength":1,"maxLength":150},"campaign":{"type":"string","minLength":1,"maxLength":150},"term":{"type":"string","maxLength":150},"content":{"type":"string","maxLength":150}}},"DeveloperUtmMutation":{"type":"object","oneOf":[{"title":"Create campaign","type":"object","additionalProperties":false,"required":["action","input"],"properties":{"action":{"type":"string","const":"campaign.create"},"input":{"$ref":"#/components/schemas/DeveloperUtmCampaignInput"}}},{"title":"Update campaign","type":"object","additionalProperties":false,"required":["action","id","input"],"properties":{"action":{"type":"string","const":"campaign.update"},"id":{"type":"string","format":"uuid"},"input":{"$ref":"#/components/schemas/DeveloperUtmCampaignInput"}}},{"title":"Duplicate campaign","type":"object","additionalProperties":false,"required":["action","id","name"],"properties":{"action":{"type":"string","const":"campaign.duplicate"},"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":80}}},{"title":"Delete campaign","type":"object","additionalProperties":false,"required":["action","id"],"properties":{"action":{"type":"string","const":"campaign.delete"},"id":{"type":"string","format":"uuid"}}},{"title":"Create saved link","type":"object","additionalProperties":false,"required":["action","input"],"properties":{"action":{"type":"string","const":"link.create"},"input":{"$ref":"#/components/schemas/DeveloperUtmLinkInput"}}},{"title":"Update saved link","type":"object","additionalProperties":false,"required":["action","id","input"],"properties":{"action":{"type":"string","const":"link.update"},"id":{"type":"string","format":"uuid"},"input":{"$ref":"#/components/schemas/DeveloperUtmLinkInput"}}},{"title":"Delete saved link","type":"object","additionalProperties":false,"required":["action","id"],"properties":{"action":{"type":"string","const":"link.delete"},"id":{"type":"string","format":"uuid"}}},{"title":"Create custom preset","type":"object","additionalProperties":false,"required":["action","input"],"properties":{"action":{"type":"string","const":"preset.create"},"input":{"$ref":"#/components/schemas/DeveloperUtmPresetInput"}}},{"title":"Delete custom preset","type":"object","additionalProperties":false,"required":["action","id"],"properties":{"action":{"type":"string","const":"preset.delete"},"id":{"type":"string","format":"uuid"}}},{"title":"Update naming rules","type":"object","additionalProperties":false,"required":["action","input"],"properties":{"action":{"type":"string","const":"settings.update"},"input":{"$ref":"#/components/schemas/DeveloperUtmNaming"}}}]},"DeveloperUtmCampaignInput":{"type":"object","additionalProperties":false,"required":["name","description","status","defaults"],"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"type":"string","maxLength":2000},"status":{"type":"string","enum":["draft","active","archived"]},"defaults":{"type":"object","additionalProperties":false,"required":["source","medium","campaign"],"properties":{"source":{"type":"string","maxLength":150},"medium":{"type":"string","maxLength":150},"campaign":{"type":"string","maxLength":150}}}}},"DeveloperUtmLinkInput":{"type":"object","additionalProperties":false,"required":["campaignId","label","destinationUrl","parameters"],"properties":{"campaignId":{"type":"string","format":"uuid"},"label":{"type":"string","minLength":1,"maxLength":120},"destinationUrl":{"type":"string","format":"uri","maxLength":2048,"description":"Absolute HTTP or HTTPS URL without embedded credentials."},"parameters":{"$ref":"#/components/schemas/DeveloperUtmRequiredParameters"}}},"DeveloperUtmPresetInput":{"type":"object","additionalProperties":false,"required":["name","description","parameters"],"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"type":"string","maxLength":2000},"parameters":{"$ref":"#/components/schemas/DeveloperUtmPartialParameters"}}},"DeveloperMarketingSignatureLifecycleReceipt":{"type":"object","additionalProperties":false,"required":["signatureId","revision","updatedAt","publishedAt"],"properties":{"signatureId":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":1,"maximum":2147483647},"updatedAt":{"type":"string","format":"date-time"},"publishedAt":{"type":["string","null"],"format":"date-time"}}},"DeveloperMarketingSignatureDomain":{"type":"object","additionalProperties":false,"required":["id","generatorId","hostname","state","hostnameStatus","sslStatus","checkedAt","dnsRecords"],"properties":{"id":{"type":"string","format":"uuid"},"generatorId":{"type":"string","format":"uuid"},"hostname":{"type":"string","maxLength":253,"description":"Canonical customer hostname."},"state":{"type":"string","enum":["pending","active","error","deleting"]},"hostnameStatus":{"type":["string","null"]},"sslStatus":{"type":["string","null"]},"checkedAt":{"type":["string","null"],"format":"date-time"},"dnsRecords":{"type":"array","description":"Customer-facing DNS instructions for hostname routing and verification.","items":{"type":"object","additionalProperties":false,"required":["type","name","value"],"properties":{"type":{"type":"string","enum":["CNAME","TXT"]},"name":{"type":"string","maxLength":253},"value":{"type":"string","maxLength":2048}}}}}},"DeveloperMarketingMicrosoftPolicyDocument":{"description":"Version-one policy. Every nonempty selector must match. Exclusions take precedence. Legacy input may omit enrollment, rule kind, and company selectors. Responses include their normalized values.","type":"object","additionalProperties":false,"required":["version","excludedUserIds","excludedGroupIds","rules"],"properties":{"version":{"type":"integer","const":1},"enrollment":{"type":"object","additionalProperties":false,"required":["allUsers","userIds","groupIds"],"properties":{"allUsers":{"type":"boolean"},"userIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Values must be unique.","maxItems":200},"groupIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Values must be unique.","maxItems":200}}},"excludedUserIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Values must be unique.","maxItems":200},"excludedGroupIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Values must be unique.","maxItems":200},"rules":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPolicyRule"},"maxItems":100}}},"DeveloperMarketingMicrosoftPolicyRule":{"type":"object","additionalProperties":false,"required":["id","name","priority","enabled","startsAt","endsAt","match","assignment"],"properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":["string","null"],"enum":["assignment","rule","default",null]},"name":{"type":"string","description":"Nonempty. Maximum length is 120 characters."},"priority":{"type":"integer","format":"int32","maximum":2147483647,"description":"Signed 32-bit priority, with a minimum of −2,147,483,648."},"enabled":{"type":"boolean"},"startsAt":{"type":["string","null"],"description":"Matches the pattern ^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(?:\\.\\d{1,3})?Z$.","format":"date-time"},"endsAt":{"type":["string","null"],"description":"Matches the pattern ^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(?:\\.\\d{1,3})?Z$.","format":"date-time"},"match":{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPolicyMatch"},"assignment":{"$ref":"#/components/schemas/DeveloperMarketingMicrosoftPolicyAssignment"}}},"DeveloperMarketingMicrosoftPolicyMatch":{"type":"object","additionalProperties":false,"required":["allUsers","userIds","groupIds","departments","officeLocations","countries","composeTypes"],"properties":{"allUsers":{"type":"boolean"},"userIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Values must be unique.","maxItems":200},"groupIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Values must be unique.","maxItems":200},"departments":{"type":"array","items":{"type":"string","description":"Nonempty. Maximum length is 256 characters."},"description":"Values must be unique.","maxItems":200},"officeLocations":{"type":"array","items":{"type":"string","description":"Nonempty. Maximum length is 256 characters."},"description":"Values must be unique.","maxItems":200},"countries":{"type":"array","items":{"type":"string","description":"Nonempty. Maximum length is 256 characters."},"description":"Values must be unique.","maxItems":200},"companies":{"type":["array","null"],"items":{"type":"string","description":"Nonempty. Maximum length is 256 characters."},"description":"Values must be unique.","maxItems":200},"composeTypes":{"type":"array","items":{"type":"string","enum":["newMail","reply","forward"]},"description":"Values must be unique.","minItems":1,"maxItems":3}}},"DeveloperMarketingMicrosoftPolicyAssignment":{"type":"object","additionalProperties":false,"required":["generatorId","locationId","locationMapping","locale","logoId","bannerMode","bannerId","fieldMapping","format","compactFieldIds"],"properties":{"generatorId":{"type":"string","format":"uuid"},"locationId":{"type":"string","description":"Maximum length is 64 characters."},"locationMapping":{"type":"object","additionalProperties":{"type":"string","description":"Nonempty. Maximum length is 64 characters."},"description":"Maps nonempty office location names of up to 256 characters to template location IDs. Maximum of 200 entries."},"locale":{"type":"string","description":"Maximum length is 35 characters."},"logoId":{"type":"string","description":"Maximum length is 64 characters."},"bannerMode":{"type":"string","enum":["auto","none","selected"]},"bannerId":{"type":"string","description":"Maximum length is 64 characters."},"fieldMapping":{"type":"object","additionalProperties":{"type":"string","enum":["displayName","givenName","surname","jobTitle","mail","senderAddress","businessPhone","mobilePhone","department","officeLocation","companyName","country","streetAddress","city","postalCode","state"]},"description":"Keys are field IDs of up to 64 letters, digits, underscores, or hyphens, beginning with a letter or digit. Reserved JavaScript property names are excluded. Maximum of 64 entries."},"format":{"type":"string","enum":["full","compact"]},"compactFieldIds":{"type":"array","items":{"type":"string","description":"Nonempty. Maximum length is 256 characters."},"description":"Values must be unique.","maxItems":64}}},"DeveloperMarketingMicrosoftPreviewResolution":{"type":"object","oneOf":[{"type":"object","additionalProperties":false,"required":["contractVersion","action","revision","resolvedAt","validUntil","signature","assets","managedMode"],"properties":{"contractVersion":{"type":"integer","const":1},"action":{"type":"string","enum":["apply"]},"revision":{"type":"string","description":"Matches the pattern ^[0-9a-f]{64}$."},"resolvedAt":{"type":"string","format":"date-time"},"validUntil":{"type":"string","format":"date-time"},"signature":{"type":"object","additionalProperties":false,"required":["html","text"],"properties":{"html":{"type":"string","description":"Rendered HTML with CID references to the included assets. Maximum length is 28000 characters."},"text":{"type":"string","description":"Maximum length is 30000 characters."}}},"assets":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["fileName","contentType","base64","fingerprint"],"properties":{"fileName":{"type":"string"},"contentType":{"type":"string","enum":["image/png","image/jpeg","image/gif"]},"base64":{"type":"string","description":"Encoded as base64."},"fingerprint":{"type":"string","description":"Matches the pattern ^[0-9a-f]{64}$."}}},"maxItems":4},"managedMode":{"type":"string","enum":["replace-dashio-signature"]}}},{"type":"object","additionalProperties":false,"required":["contractVersion","action","reason"],"properties":{"contractVersion":{"type":"integer","const":1},"action":{"type":"string","enum":["skip"]},"reason":{"type":"string","enum":["no_assignment","not_enrolled","missing_required_fields","no_published_configuration","unsupported_sender"]}}}]},"DeveloperComplianceWorkspaceBackup":{"type":"object","required":["schemaVersion","exportedAt","collections","frameworkAssessments"],"additionalProperties":false,"properties":{"schemaVersion":{"type":"integer","const":2},"frameworkAssessments":{"$ref":"#/components/schemas/DeveloperPortableFrameworkHistory"},"exportedAt":{"type":"string","format":"date-time"},"collections":{"type":"object","additionalProperties":false,"required":["compliance:contacts","compliance:controls","compliance:evidence","compliance:statements-of-applicability","compliance:questionnaires","compliance:questionnaire-answers","compliance:risks","compliance:suppliers","compliance:incidents","compliance:training","compliance:training-courses","compliance:training-policies","compliance:trust:certifications","compliance:trust:documents","compliance:trust:subprocessors","compliance:trust:access-requests"],"properties":{"compliance:contacts":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:controls":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:evidence":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:statements-of-applicability":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:questionnaires":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:questionnaire-answers":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:risks":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:suppliers":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:incidents":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:training":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:training-courses":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:training-policies":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:certifications":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:documents":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:subprocessors":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:access-requests":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}}}}}},"DeveloperPortableFrameworkHistory":{"type":"object","additionalProperties":false,"required":["assessments","snapshots"],"properties":{"assessments":{"type":"array","maxItems":1000,"items":{"$ref":"#/components/schemas/DeveloperPortableFrameworkAssessment"}},"snapshots":{"type":"array","items":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentSnapshot"},{"type":"object","required":["assessmentId","sourceSpaceId","capture"],"properties":{"assessmentId":{"type":"string","format":"uuid"},"sourceSpaceId":{"type":"string","format":"uuid"},"capture":{"type":"object","required":["formatVersion","spaceSlug","assessment"],"properties":{"formatVersion":{"type":"integer","enum":[1,2,3]},"spaceSlug":{"type":"string"},"assessment":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperPortableFrameworkAssessment"},{"type":"object","required":["controls","evidence"],"properties":{"controls":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentRecord"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentRecord"}}}}]}}}}}]}}}},"DeveloperPortableFrameworkAssessment":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentSummary"},{"type":"object","required":["entries"],"properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperPortableFrameworkDecision"}}}}]},"DeveloperFrameworkAssessmentSummary":{"type":"object","required":["id","releaseId","scope","periodStart","periodEnd","revision","createdBy","createdAt","predecessorId","predecessorRevision","predecessorSnapshotId","upgradeMappings"],"properties":{"id":{"type":"string","format":"uuid"},"releaseId":{"type":"string"},"scope":{"type":"string"},"periodStart":{"type":"string","format":"date"},"periodEnd":{"type":"string","format":"date"},"revision":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"string","format":"uuid"},"predecessorId":{"type":["string","null"]},"predecessorRevision":{"type":["integer","null"]},"predecessorSnapshotId":{"type":["string","null"]},"upgradeMappings":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentMapping"}}}},"DeveloperFrameworkAssessmentMapping":{"type":"object","required":["kind","from","to"],"properties":{"kind":{"type":"string","enum":["renumber","split","merge"]},"from":{"type":"array","items":{"type":"string"}},"to":{"type":"array","items":{"type":"string"}},"basis":{"type":"string"},"locator":{"type":"string"}}},"DeveloperPortableFrameworkDecision":{"type":"object","required":["requirementId","applicability","implementation","rationale","controlIds","evidenceIds","needsReview","reviewedAt","reviewedBy"],"properties":{"requirementId":{"type":"string"},"applicability":{"type":"string","enum":["unassessed","applicable","not-applicable"]},"implementation":{"type":"string","enum":["unassessed","not-started","in-progress","implemented"]},"rationale":{"type":"string"},"controlIds":{"type":"array","items":{"type":"string"}},"evidenceIds":{"type":"array","items":{"type":"string"}},"needsReview":{"type":"boolean"},"reviewedAt":{"type":"string","format":"date-time"},"reviewedBy":{"type":"string","format":"uuid"}}},"DeveloperFrameworkAssessmentSnapshot":{"type":"object","required":["id","revision","recordedBy","recordedAt"],"properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer"},"recordedBy":{"type":"string","format":"uuid"},"recordedAt":{"type":"string","format":"date-time"}}},"DeveloperFrameworkAssessmentRecord":{"type":"object","required":["id","label","status","missing"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"status":{"type":"string"},"missing":{"type":"boolean"},"attachment":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentAttachment"},"evidenceKind":{"type":"string","enum":["Period-based","Point-in-time","Standing document"]},"submittedAt":{"type":"string"},"reviewedAt":{"type":"string"},"collectedOn":{"type":"string"},"coverageStart":{"type":"string"},"coverageEnd":{"type":"string"},"renewalDate":{"type":"string"}}},"DeveloperFrameworkAssessmentAttachment":{"type":["object","null"],"description":"Format 3 private-file metadata observed at capture. Availability describes the storage catalog at that time.","required":["id","name","mimeType","size","storageVersion","objectVersion","base64Sha256","sha256","availability"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"mimeType":{"type":"string"},"size":{"type":"integer"},"storageVersion":{"type":"integer","const":1},"objectVersion":{"type":["string","null"]},"base64Sha256":{"type":"string","description":"SHA-256 of the original encoded base64 text used by private storage."},"sha256":{"type":["string","null"],"description":"SHA-256 of verified file bytes when available."},"availability":{"type":"string","enum":["registered","unavailable","unverified"]}}},"DeveloperComplianceBackupRecord":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Stable record ID, up to 180 UTF-16 code units."}},"description":"Collection-specific fields from a Compliance Portal backup. Keep the exported record unchanged."},"DeveloperFrameworkReleaseSummary":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperFrameworkReleaseMetadata"},{"type":"object","required":["requirementCount"],"properties":{"requirementCount":{"type":"integer","minimum":0},"supersededBy":{"type":"string","description":"Use this corrected release for new assessments. Existing assessments retain the exact historical source."}}}]},"DeveloperFrameworkReleaseMetadata":{"type":"object","required":["schemaVersion","id","framework","publisher","edition","sourceRevision","language","retrievedAt","rights","artifacts","dates"],"properties":{"schemaVersion":{"type":"integer","const":1},"id":{"type":"string"},"framework":{"type":"string","enum":["eu-ai-act","bsi-c5","vda-isa"]},"publisher":{"type":"string"},"edition":{"type":"string"},"sourceRevision":{"type":"string"},"language":{"type":"string"},"retrievedAt":{"type":"string","format":"date"},"dates":{"type":"object","additionalProperties":{"type":"string","format":"date"}},"artifacts":{"type":"array","items":{"type":"object","required":["url","sha256","filename"],"properties":{"url":{"type":"string","format":"uri"},"sha256":{"type":"string"},"filename":{"type":"string"}}}},"rights":{"type":"object","required":["basis","attribution","noticeUrls","notices","display","export"],"properties":{"basis":{"type":"string"},"attribution":{"type":"string"},"noticeUrls":{"type":"array","items":{"type":"string","format":"uri"}},"notices":{"type":"array","items":{"type":"string"}},"display":{"type":"boolean"},"export":{"type":"boolean"}}}}},"DeveloperFrameworkRequirementRelease":{"type":"object","required":["id","edition","language","sourceRevision","rights"],"properties":{"id":{"type":"string"},"edition":{"type":"string"},"language":{"type":"string"},"sourceRevision":{"type":"string"},"rights":{"type":"object","required":["basis","attribution","noticeUrls","notices","display","export"],"properties":{"basis":{"type":"string"},"attribution":{"type":"string"},"noticeUrls":{"type":"array","items":{"type":"string","format":"uri"}},"notices":{"type":"array","items":{"type":"string"}},"display":{"type":"boolean"},"export":{"type":"boolean"}}}}},"DeveloperFrameworkSourceNode":{"type":"object","required":["id","parentId","kind","locator","title","text","assessable"],"properties":{"id":{"type":"string"},"parentId":{"type":["string","null"]},"kind":{"type":"string","enum":["requirement","section","context","definition","reference","recital"]},"locator":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"assessable":{"type":"boolean"},"attributes":{"type":"object","additionalProperties":{"type":["string","array"],"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"guidance":{"type":"object","required":["explanation","actions","evidenceExamples"],"properties":{"explanation":{"type":"string"},"actions":{"type":"array","items":{"type":"string"}},"evidenceExamples":{"type":"array","items":{"type":"string"}}}}}},"DeveloperFrameworkAssessmentDetail":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperFrameworkCapturedAssessment"},{"type":"object","properties":{"evidenceReview":{"type":"object","required":["formatVersion","asOf","evidenceContext"],"properties":{"formatVersion":{"type":"integer","enum":[1,2]},"asOf":{"type":"string","format":"date"},"evidenceContext":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkEvidenceContext"}}}}}}]},"DeveloperFrameworkCapturedAssessment":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentSummary"},{"type":"object","required":["entries","progress","controls","evidence","snapshots"],"properties":{"entries":{"type":"array","items":{"type":"object","required":["requirementId","applicability","implementation","rationale","controlIds","evidenceIds","needsReview","reviewedBy","reviewedAt"],"properties":{"requirementId":{"type":"string"},"applicability":{"type":"string","enum":["unassessed","applicable","not-applicable"]},"implementation":{"type":"string","enum":["unassessed","not-started","in-progress","implemented"]},"rationale":{"type":"string"},"controlIds":{"type":"array","items":{"type":"string"}},"evidenceIds":{"type":"array","items":{"type":"string"}},"needsReview":{"type":"boolean"},"reviewedAt":{"type":["string","null"]},"reviewedBy":{"type":["string","null"]}}}},"controls":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentRecord"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentRecord"}},"snapshots":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentSnapshot"}},"progress":{"type":"object","required":["total","excluded","denominator","implemented","unresolved","needsReview","internallyVerifiedEvidence"],"properties":{"total":{"type":"integer"},"excluded":{"type":"integer"},"denominator":{"type":"integer"},"implemented":{"type":"integer"},"unresolved":{"type":"integer"},"needsReview":{"type":"integer"},"internallyVerifiedEvidence":{"type":"integer"}}}}}]},"DeveloperFrameworkEvidenceContext":{"type":"object","required":["id","freshness","coverage","findings"],"properties":{"id":{"type":"string"},"freshness":{"type":"string","enum":["Current","Due soon","Renewal overdue","Not recorded","Not submitted"]},"coverage":{"type":"string","enum":["Not recorded","Overlaps period","Outside period","Point-in-time","Standing document","Not submitted"]},"findings":{"type":"array","items":{"type":"object","required":["severity","reason"],"properties":{"severity":{"type":"string","enum":["Action","Context"]},"reason":{"type":"string"}}}}}},"DeveloperFrameworkAssessmentUpgradePreview":{"type":"object","required":["fromReleaseId","toReleaseId","added","removed","changed","unchanged","suggestions"],"properties":{"fromReleaseId":{"type":"string"},"toReleaseId":{"type":"string"},"added":{"type":"array","items":{"type":"string"}},"removed":{"type":"array","items":{"type":"string"}},"changed":{"type":"array","items":{"type":"string"}},"unchanged":{"type":"array","items":{"type":"string"}},"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentMapping"}}}},"DeveloperFrameworkAssessmentHandoff":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentHandoffData"}],"oneOf":[{"type":"object","required":["schemaVersion"],"properties":{"schemaVersion":{"type":"integer","const":1}}},{"type":"object","required":["schemaVersion","asOf","evidenceContext"],"properties":{"schemaVersion":{"type":"integer","enum":[2,3]},"asOf":{"type":"string","format":"date"},"evidenceContext":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkEvidenceContext"}}}}]},"DeveloperFrameworkAssessmentHandoffData":{"type":"object","required":["schemaVersion","spaceId","snapshot","source","originalDownloads","originalFiles","assessment","openGaps"],"properties":{"restoredFrom":{"type":"object","description":"Original capture Space on cross-Space restoration. Publisher download links are issued for the destination.","required":["spaceId","spaceSlug"],"properties":{"spaceId":{"type":"string","format":"uuid"},"spaceSlug":{"type":"string"}}},"schemaVersion":{"type":"integer","enum":[1,2,3]},"spaceId":{"type":"string","format":"uuid"},"snapshot":{"$ref":"#/components/schemas/DeveloperFrameworkAssessmentSnapshot"},"source":{"$ref":"#/components/schemas/DeveloperFrameworkRelease"},"originalFiles":{"type":"array","items":{"type":"object","required":["filename","sha256","encoding","content"],"properties":{"filename":{"type":"string"},"sha256":{"type":"string"},"encoding":{"type":"string","const":"base64"},"content":{"type":"string"}}}},"originalDownloads":{"type":"array","items":{"type":"object","required":["filename","sha256","path"],"properties":{"filename":{"type":"string"},"sha256":{"type":"string"},"path":{"type":"string"}}}},"assessment":{"$ref":"#/components/schemas/DeveloperFrameworkCapturedAssessment"},"openGaps":{"type":"array","items":{"type":"object","required":["requirementId","reasons"],"properties":{"requirementId":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}}}}}}},"DeveloperFrameworkRelease":{"type":"object","allOf":[{"$ref":"#/components/schemas/DeveloperFrameworkReleaseMetadata"},{"type":"object","required":["nodes"],"properties":{"nodes":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperFrameworkSourceNode"}}}}]},"DeveloperComplianceContact":{"type":"object","additionalProperties":false,"required":["id","name","status"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":180},"status":{"type":"string","maxLength":40}}},"DeveloperComplianceMutationReceipt":{"type":"object","additionalProperties":false,"required":["recordId","revision","changed"],"properties":{"recordId":{"type":"string","description":"Stable ID of the affected record."},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changed":{"type":"boolean","description":"Whether the workspace changed."}}},"DeveloperComplianceAuditExportScope":{"type":"object","additionalProperties":false,"required":["framework","periodStart","periodEnd","ownerContactId"],"properties":{"framework":{"type":"string","description":"Saved framework selector, or all for every framework."},"periodStart":{"type":"string","description":"ISO calendar date or empty. Supply both dates or leave both empty."},"periodEnd":{"type":"string","description":"ISO calendar date on or after the start, or empty."},"ownerContactId":{"type":"string","description":"Saved contact ID, or empty for all owners. Required for audit-owner-brief."}}},"DeveloperComplianceExportRequest":{"type":"object","oneOf":[{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["statement"]},"id":{"type":"string","description":"Saved record ID, at most 180 characters."},"revision":{"type":"integer","minimum":1}},"additionalProperties":false},{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["questionnaire","evidence-record","trust-document","trust-document-text","trust-assurance","trust-review","trust-approved-request"]},"id":{"type":"string","description":"Saved record ID, at most 180 characters."}},"additionalProperties":false},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["trust-security-package"]}},"additionalProperties":false},{"type":"object","required":["type","scope"],"properties":{"type":{"type":"string","enum":["audit-snapshot","audit-evidence-index","audit-owner-brief"]},"scope":{"$ref":"#/components/schemas/DeveloperComplianceAuditExportScope"}},"additionalProperties":false},{"type":"object","required":["type","exportKey","format","scope","recordIds","columns"],"properties":{"type":{"type":"string","enum":["table"]},"exportKey":{"type":"string","enum":["audit-preparation","contacts","controls","evidence","incidents","suppliers","training","trust-certifications","trust-documents","trust-subprocessors","trust-access-requests"]},"format":{"type":"string","enum":["csv","json","xlsx"]},"scope":{"type":"string","enum":["filtered","page","selected"]},"recordIds":{"type":"array","items":{"type":"string","description":"Saved record ID, at most 180 characters."},"maxItems":2000},"auditScope":{"$ref":"#/components/schemas/DeveloperComplianceAuditExportScope"},"columns":{"type":"array","items":{"type":"string","description":"Column allowed for the selected inventory."},"minItems":1,"maxItems":20}},"additionalProperties":false},{"type":"object","required":["type","format","scope","query","selectedIds","columns","treatment","heatmapCell"],"properties":{"type":{"type":"string","enum":["risks"]},"format":{"type":"string","enum":["csv","json","xlsx"]},"scope":{"type":"string","enum":["filtered","page","selected"]},"query":{"$ref":"#/components/schemas/DeveloperComplianceRiskExportQuery"},"selectedIds":{"type":"array","items":{"type":"string","description":"Saved record ID, at most 180 characters."},"maxItems":2000},"columns":{"type":"array","items":{"type":"string","enum":["title","id","category","likelihood","impact","inherent","residual","owner","dueDate","treatment","status"]},"minItems":1,"maxItems":11},"treatment":{"type":"string","enum":["all","Mitigate","Transfer","Accept","Avoid"]},"heatmapCell":{"type":"string","description":"Empty or a likelihood-impact pair from 1-1 through 5-5."}},"additionalProperties":false}]},"DeveloperComplianceRiskExportQuery":{"type":"object","required":["search","filters","filterMode","sorting","grouping","page","pageSize"],"properties":{"search":{"type":"string","description":"At most 4,000 characters."},"filters":{"type":"array","items":{"type":"object","required":["id","column","operator"],"properties":{"id":{"type":"string","description":"Saved record ID, at most 180 characters."},"column":{"type":"string","enum":["title","id","category","likelihood","impact","inherent","residual","owner","dueDate","treatment","status"]},"operator":{"type":"string","enum":["contains","notContains","equals","notEquals","startsWith","endsWith","gt","gte","lt","lte","between","in","notIn","empty","notEmpty"]},"value":{"type":["string","number","boolean","null","array"],"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"type":["string","number"],"oneOf":[{"type":"string"},{"type":"number"}]},"maxItems":2000}]}},"additionalProperties":false},"maxItems":32},"filterMode":{"type":"string","enum":["and","or"]},"sorting":{"type":"array","items":{"type":"object","required":["id","desc"],"properties":{"id":{"type":"string","enum":["title","id","category","likelihood","impact","inherent","residual","owner","dueDate","treatment","status"]},"desc":{"type":"boolean"}},"additionalProperties":false},"maxItems":11},"grouping":{"type":"array","items":{"type":"string","enum":["category","owner","treatment","status"]},"maxItems":4},"page":{"type":"integer","minimum":1,"maximum":1000000},"pageSize":{"type":"integer","enum":[10,25,50,100]}},"additionalProperties":false},"DeveloperComplianceBackupInput":{"type":"object","required":["schemaVersion","collections"],"additionalProperties":false,"oneOf":[{"type":"object","additionalProperties":false,"properties":{"schemaVersion":{"type":"integer","const":1},"exportedAt":{"type":"string","format":"date-time"},"collections":{"type":"object"}}},{"type":"object","properties":{"schemaVersion":{"type":"integer","const":2},"collections":{"type":"object","required":["compliance:statements-of-applicability","compliance:questionnaires","compliance:questionnaire-answers"]}},"required":["frameworkAssessments"]}],"properties":{"schemaVersion":{"type":"integer","enum":[1,2]},"frameworkAssessments":{"$ref":"#/components/schemas/DeveloperPortableFrameworkHistory"},"exportedAt":{"type":"string","format":"date-time","description":"Optional export time. Repeat detection uses the backup contents."},"collections":{"type":"object","additionalProperties":false,"required":["compliance:contacts","compliance:controls","compliance:evidence","compliance:risks","compliance:suppliers","compliance:incidents","compliance:training","compliance:training-courses","compliance:training-policies","compliance:trust:certifications","compliance:trust:documents","compliance:trust:subprocessors","compliance:trust:access-requests"],"description":"Legacy version 1 backups may omit the Statement of Applicability and the two questionnaire collections.","properties":{"compliance:contacts":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:controls":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:evidence":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:statements-of-applicability":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:questionnaires":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:questionnaire-answers":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:risks":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:suppliers":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:incidents":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:training":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:training-courses":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:training-policies":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:certifications":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:documents":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:subprocessors":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}},"compliance:trust:access-requests":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/DeveloperComplianceBackupRecord"}}}}}},"DeveloperComplianceImportPreview":{"type":"object","required":["frameworkAssessments","counts","pausedSchedules","conflicts","revision","commitSupported","commitBlockers","additionalRequiredScopes"],"additionalProperties":false,"properties":{"frameworkAssessments":{"$ref":"#/components/schemas/DeveloperPortableFrameworkCounts"},"counts":{"type":"object","additionalProperties":false,"required":["compliance:contacts","compliance:controls","compliance:evidence","compliance:statements-of-applicability","compliance:questionnaires","compliance:questionnaire-answers","compliance:risks","compliance:suppliers","compliance:incidents","compliance:training","compliance:training-courses","compliance:training-policies","compliance:trust:certifications","compliance:trust:documents","compliance:trust:subprocessors","compliance:trust:access-requests"],"properties":{"compliance:contacts":{"type":"integer","minimum":0,"maximum":2000},"compliance:controls":{"type":"integer","minimum":0,"maximum":2000},"compliance:evidence":{"type":"integer","minimum":0,"maximum":2000},"compliance:statements-of-applicability":{"type":"integer","minimum":0,"maximum":2000},"compliance:questionnaires":{"type":"integer","minimum":0,"maximum":2000},"compliance:questionnaire-answers":{"type":"integer","minimum":0,"maximum":2000},"compliance:risks":{"type":"integer","minimum":0,"maximum":2000},"compliance:suppliers":{"type":"integer","minimum":0,"maximum":2000},"compliance:incidents":{"type":"integer","minimum":0,"maximum":2000},"compliance:training":{"type":"integer","minimum":0,"maximum":2000},"compliance:training-courses":{"type":"integer","minimum":0,"maximum":2000},"compliance:training-policies":{"type":"integer","minimum":0,"maximum":2000},"compliance:trust:certifications":{"type":"integer","minimum":0,"maximum":2000},"compliance:trust:documents":{"type":"integer","minimum":0,"maximum":2000},"compliance:trust:subprocessors":{"type":"integer","minimum":0,"maximum":2000},"compliance:trust:access-requests":{"type":"integer","minimum":0,"maximum":2000}}},"pausedSchedules":{"type":"integer","minimum":0,"maximum":2000,"description":"Number of non-manual supplier schedules in the backup. Newly imported schedules stay paused."},"conflicts":{"type":"integer","minimum":0,"description":"Number of incoming IDs that differ from saved records."},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"commitSupported":{"type":"boolean","description":"True when the contents are eligible for Developer import. Revision, conflicts and plan limits still apply."},"commitBlockers":{"type":"array","maxItems":2,"items":{"type":"string","enum":["attachment-limit","approved-disclosures"]},"description":"Content that requires the Compliance Portal to restore."},"additionalRequiredScopes":{"type":"array","maxItems":1,"items":{"type":"string","enum":["compliance:evidence:write"]},"description":"Additional permission required to commit this backup when it adds or links a file."}}},"DeveloperPortableFrameworkCounts":{"type":"object","required":["assessments","decisions","snapshots"],"properties":{"assessments":{"type":"integer","minimum":0},"decisions":{"type":"integer","minimum":0},"snapshots":{"type":"integer","minimum":0}}},"DeveloperComplianceIncident":{"type":"object","additionalProperties":false,"required":["id","title","severity","status","reportedAt"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","maxLength":512},"severity":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"reportedAt":{"type":"string","maxLength":64,"description":"Saved report time."}}},"DeveloperComplianceQuestionnaireAnswer":{"type":"object","additionalProperties":false,"required":["id","title"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","maxLength":512}}},"DeveloperComplianceQuestionnaire":{"type":"object","additionalProperties":false,"required":["id","title","direction","status","dueDate"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","maxLength":512},"direction":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"dueDate":{"type":"string","maxLength":32,"description":"Saved due date or an empty string when none is recorded."}}},"DeveloperComplianceStatementOfApplicability":{"type":"object","additionalProperties":false,"required":["id","title","sourceEdition","annexAReviewed"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","maxLength":512},"sourceEdition":{"type":"string","maxLength":180},"annexAReviewed":{"type":"boolean","description":"Whether the statement records an Annex A review."}}},"DeveloperSupplierDeliveryPlan":{"type":"object","additionalProperties":false,"required":["id","sourceCaseId","state","mode","timeZone","nextDate","responseWindowDays","intervalMonths","reminderDays"],"properties":{"id":{"type":"string","format":"uuid"},"sourceCaseId":{"type":"string"},"state":{"type":"string","enum":["active","paused","held","complete"]},"mode":{"type":"string","enum":["Manual","One-off","Recurring"]},"timeZone":{"type":"string"},"nextDate":{"type":["string","null"],"format":"date"},"responseWindowDays":{"type":"integer","minimum":1,"maximum":365},"intervalMonths":{"type":["integer","null"]},"reminderDays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":364},"maxItems":10}}},"DeveloperSupplierDeliveryCase":{"type":"object","additionalProperties":false,"required":["id","status","blockedReason","scheduledDate","dueDate","version","acceptedEmails","failedEmails","pendingEmails","submissionCount"],"properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["awaiting_response","submitted","changes_requested","approved","closed"]},"blockedReason":{"type":["string","null"],"enum":[null,"bounced","revoked"]},"scheduledDate":{"type":"string","format":"date"},"dueDate":{"type":"string","format":"date"},"version":{"type":"integer","minimum":1,"maximum":2147483647},"acceptedEmails":{"type":"integer","minimum":0},"failedEmails":{"type":"integer","minimum":0},"pendingEmails":{"type":"integer","minimum":0},"submissionCount":{"type":"integer","minimum":0}}},"DeveloperSupplierDeliveryEvidence":{"type":"object","additionalProperties":false,"required":["id","name","mediaType","bytes","revision"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"mediaType":{"type":"string","enum":["application/pdf","image/png","image/jpeg"]},"bytes":{"type":"integer","minimum":1,"maximum":5000000},"revision":{"type":"integer","minimum":1,"maximum":2147483647}}},"DeveloperSupplierDeliveryReceipt":{"type":"object","oneOf":[{"title":"Plan acknowledgement","type":"object","additionalProperties":false,"required":["action","planId","state","replayed"],"properties":{"action":{"type":"string","enum":["confirm","pause"]},"planId":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["active","paused"]},"replayed":{"type":"boolean"}}},{"title":"Case acknowledgement","type":"object","additionalProperties":false,"required":["action","caseId","version","replayed"],"properties":{"action":{"type":"string","enum":["send","reopen","review","revoke","close"]},"caseId":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":1,"maximum":2147483647},"replayed":{"type":"boolean"}}}]},"DeveloperComplianceTrainingAssignment":{"type":"object","additionalProperties":false,"required":["id","courseId","dueDate","progress"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"courseId":{"type":"string","maxLength":200,"description":"Stable ID of the assigned course."},"dueDate":{"type":"string","maxLength":32,"description":"Saved due date or an empty string when none is recorded."},"progress":{"type":"integer","minimum":0,"maximum":100,"description":"Saved completion percentage."}}},"DeveloperComplianceTrainingCourse":{"type":"object","additionalProperties":false,"required":["id","title","durationMinutes"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","maxLength":512},"durationMinutes":{"type":"integer","minimum":1,"maximum":1440,"description":"Saved course duration in minutes."}}},"DeveloperComplianceTrustAccessRequest":{"type":"object","additionalProperties":false,"required":["id","status","createdAt","reviewedAt"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","maxLength":80},"createdAt":{"type":"string","maxLength":64,"description":"Saved request creation time."},"reviewedAt":{"type":["string","null"],"maxLength":64,"description":"Saved decision time, or null while the request is pending."}}},"DeveloperComplianceTrustCertification":{"type":"object","additionalProperties":false,"required":["id","title","issuer","status","expiryDate","gated"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","maxLength":512},"issuer":{"type":"string","maxLength":180},"status":{"type":"string","maxLength":80},"expiryDate":{"type":"string","maxLength":32,"description":"Saved expiry date or an empty string when none is recorded."},"gated":{"type":"boolean","description":"Whether access to the underlying content is restricted."}}},"DeveloperComplianceTrustDocument":{"type":"object","additionalProperties":false,"required":["id","title","gated","updatedAt"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","maxLength":512},"gated":{"type":"boolean","description":"Whether access to the underlying content is restricted."},"updatedAt":{"type":"string","maxLength":64,"description":"Saved update time."}}},"DeveloperComplianceTrustSubprocessor":{"type":"object","additionalProperties":false,"required":["id","name","purpose","region"],"properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":512},"purpose":{"type":"string","maxLength":512},"region":{"type":"string","maxLength":180}}},"DeveloperComplianceWorkspaceReadCollections":{"type":"object","required":["compliance:contacts","compliance:controls","compliance:evidence","compliance:statements-of-applicability","compliance:questionnaires","compliance:questionnaire-answers","compliance:risks","compliance:suppliers","compliance:incidents","compliance:training","compliance:training-courses","compliance:training-policies","compliance:trust:certifications","compliance:trust:documents","compliance:trust:subprocessors","compliance:trust:access-requests"],"properties":{"compliance:contacts":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadContactRecord"},"maxItems":2000},"compliance:controls":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadControl"},"maxItems":2000},"compliance:evidence":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadEvidence"},"maxItems":2000},"compliance:statements-of-applicability":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadStatementOfApplicability"},"maxItems":2000},"compliance:questionnaires":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireCase"},"maxItems":2000},"compliance:questionnaire-answers":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireAnswer"},"maxItems":2000},"compliance:risks":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadRiskRecord"},"maxItems":2000},"compliance:suppliers":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadSupplierRecord"},"maxItems":2000},"compliance:incidents":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadIncidentRecord"},"maxItems":2000},"compliance:training":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrainingAssignment"},"maxItems":2000},"compliance:training-courses":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrainingCourse"},"maxItems":2000},"compliance:training-policies":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrainingPolicy"},"maxItems":2000},"compliance:trust:certifications":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrustCertification"},"maxItems":2000},"compliance:trust:documents":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrustDocument"},"maxItems":2000},"compliance:trust:subprocessors":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrustSubprocessor"},"maxItems":2000},"compliance:trust:access-requests":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadTrustAccessRequest"},"maxItems":2000}},"description":"Workspace records keyed by stable collection IDs shared with schema v1 backups.","additionalProperties":false},"DeveloperComplianceWorkspaceReadContactRecord":{"type":"object","required":["id","name","email","department","role","status","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"email":{"type":"string"},"department":{"type":"string"},"role":{"type":"string","description":"Job role from Space member management."},"status":{"type":"string","enum":["Active","Inactive"]},"notes":{"type":"string"},"avatarUrl":{"type":"string","description":"Optional image URL retained on a historical contact."}},"description":"A person who can own records or receive a training assignment.","additionalProperties":false},"DeveloperComplianceWorkspaceReadControl":{"type":"object","required":["id","title","frameworks","ownerContactId","status","dueDate","description","owner","updated","activity"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"frameworks":{"type":"array","items":{"type":"string"}},"ownerContactId":{"type":"string"},"status":{"type":"string"},"dueDate":{"type":"string"},"description":{"type":"string"},"requirementMappings":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadControlRequirementMapping"}},"templateId":{"type":"string"},"owner":{"type":"string"},"updated":{"type":"string"},"activity":{"type":"array","items":{"type":"string"}}},"description":"Persisted control, including accountable owner and activity history.","additionalProperties":false},"DeveloperComplianceWorkspaceReadControlRequirementMapping":{"type":"object","required":["framework","reference"],"properties":{"framework":{"type":"string"},"reference":{"type":"string"},"sourceVersion":{"type":"string"},"scope":{"type":"string"}},"description":"Workspace-authored traceability from a control to references in a framework.","additionalProperties":false},"DeveloperComplianceWorkspaceReadEvidence":{"type":"object","required":["name","controlId","ownerContactId","dueDate","description","sourceUrl","id","owner","status","date","requestedAt","submittedAt","reviewedAt","reviewedByContactId","reviewNotes"],"properties":{"evidenceKind":{"type":"string","enum":["Period-based","Point-in-time","Standing document"]},"collectedOn":{"type":"string"},"coverageStart":{"type":"string"},"coverageEnd":{"type":"string"},"renewalDate":{"type":"string"},"sourceSystem":{"type":"string"},"acceptanceCriteria":{"type":"string"},"additionalControlIds":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"controlId":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"description":{"type":"string"},"sourceUrl":{"type":"string"},"attachment":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceAttachmentMetadata"},"id":{"type":"string","description":"Stable record identifier."},"owner":{"type":"string"},"status":{"type":"string"},"date":{"type":"string"},"requestedAt":{"type":"string"},"submittedAt":{"type":"string"},"reviewedAt":{"type":"string"},"reviewedByContactId":{"type":"string"},"reviewNotes":{"type":"string"},"reviewHistory":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadEvidenceReviewDecision"}}},"description":"Evidence requests and submissions share one reviewable record.","additionalProperties":false},"DeveloperComplianceWorkspaceAttachmentMetadata":{"type":"object","additionalProperties":false,"required":["id","name","mimeType","size"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"mimeType":{"type":"string"},"size":{"type":"integer","minimum":0,"maximum":1000000}},"description":"Saved attachment metadata. Use the same ID and metadata to retain the file. File bytes and storage locators are excluded."},"DeveloperComplianceWorkspaceReadEvidenceReviewDecision":{"type":"object","required":["reviewedAt","reviewedByContactId","status","reviewNotes"],"properties":{"reviewedAt":{"type":"string"},"reviewedByContactId":{"type":"string"},"status":{"type":"string","enum":["Verified","Changes requested"]},"reviewNotes":{"type":"string"}},"description":"An actual internal review decision retained when evidence is revised or resubmitted.","additionalProperties":false},"DeveloperComplianceWorkspaceReadStatementOfApplicability":{"type":"object","required":["title","scope","sourceEdition","annexAReviewed","id","entries","revisions"],"properties":{"title":{"type":"string"},"scope":{"type":"string"},"sourceEdition":{"type":"string"},"annexAReviewed":{"type":"boolean"},"id":{"type":"string","description":"Stable record identifier."},"entries":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadSoaEntry"}},"revisions":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadSoaRevision"}}},"description":"A scoped statement with an editable draft and recorded revision history.","additionalProperties":false},"DeveloperComplianceWorkspaceReadSoaEntry":{"type":"object","required":["kind","reference","title","decision","rationale","implementation","controlId","id"],"properties":{"kind":{"type":"string","enum":["Annex A reference","Organization control"]},"reference":{"type":"string"},"title":{"type":"string"},"decision":{"type":"string","enum":["Unassessed","Included","Excluded"]},"rationale":{"type":"string"},"implementation":{"type":"string","enum":["Not assessed","Not started","In progress","Implemented"]},"controlId":{"type":"string"},"id":{"type":"string","description":"Stable record identifier."}},"description":"An identified row of the current statement.","additionalProperties":false},"DeveloperComplianceWorkspaceReadSoaRevision":{"type":"object","required":["title","scope","sourceEdition","annexAReviewed","number","recordedAt","note","entries"],"properties":{"title":{"type":"string"},"scope":{"type":"string"},"sourceEdition":{"type":"string"},"annexAReviewed":{"type":"boolean"},"number":{"type":"number"},"recordedAt":{"type":"string"},"note":{"type":"string"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadSoaRevisionEntry"}}},"description":"A recorded copy of a statement at a point in time.","additionalProperties":false},"DeveloperComplianceWorkspaceReadSoaRevisionEntry":{"type":"object","required":["kind","reference","title","decision","rationale","implementation","controlId","id"],"properties":{"kind":{"type":"string","enum":["Annex A reference","Organization control"]},"reference":{"type":"string"},"title":{"type":"string"},"decision":{"type":"string","enum":["Unassessed","Included","Excluded"]},"rationale":{"type":"string"},"implementation":{"type":"string","enum":["Not assessed","Not started","In progress","Implemented"]},"controlId":{"type":"string"},"id":{"type":"string","description":"Stable record identifier."},"linkedControlTitle":{"type":"string"}},"description":"A historical row can retain the control name as recorded.","additionalProperties":false},"DeveloperComplianceWorkspaceReadQuestionnaireCase":{"type":"object","required":["title","counterparty","scope","ownerContactId","supplierId","dueDate","sourceUrl","direction","id","status","questions","artifacts","reviews","createdAt","updatedAt"],"properties":{"supplierReviewId":{"type":"string","format":"uuid","description":"Private navigation reference to the supplier review that prepared this questionnaire."},"title":{"type":"string"},"counterparty":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"},"supplierId":{"type":"string"},"dueDate":{"type":"string"},"sourceUrl":{"type":"string"},"direction":{"type":"string","enum":["Customer response","Supplier assessment"]},"serviceType":{"type":"string","enum":["Software","Cloud service","Professional services","Other"]},"id":{"type":"string","description":"Stable record identifier."},"status":{"type":"string","enum":["Draft","In review","Changes requested","Approved","Completed"]},"questions":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireQuestion"}},"artifacts":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireArtifact"}},"reviews":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireReview"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"description":"A working case with independently identified items and review events.","additionalProperties":false},"DeveloperComplianceWorkspaceReadQuestionnaireQuestion":{"type":"object","required":["prompt","answer","required","reusableAnswerId","id"],"properties":{"prompt":{"type":"string"},"answer":{"type":"string"},"required":{"type":"boolean"},"reusableAnswerId":{"type":"string"},"supportingContactId":{"type":"string","description":"Contact in this Space who can substantiate this answer."},"supportingSupplierContact":{"type":"string","description":"Supplier contact details recorded with this answer."},"supportingEvidenceId":{"type":"string","description":"Evidence record in this Space containing the supporting document."},"supportingUrl":{"type":"string","description":"Private HTTPS reference for this item."},"id":{"type":"string","description":"Stable record identifier."}},"description":"An identified question and its case-specific answer.","additionalProperties":false},"DeveloperComplianceWorkspaceReadQuestionnaireArtifact":{"type":"object","required":["title","kind","scope","url","required","id"],"properties":{"title":{"type":"string"},"kind":{"type":"string","enum":["ISO 27001 certificate","Statement of Applicability","SBOM","Security policy","Other"]},"scope":{"type":"string"},"url":{"type":"string"},"required":{"type":"boolean"},"handoffNote":{"type":"string","description":"Internal location or handoff note when no link can be recorded."},"id":{"type":"string","description":"Stable record identifier."}},"description":"An identified artifact request within one case.","additionalProperties":false},"DeveloperComplianceWorkspaceReadQuestionnaireReview":{"type":"object","required":["id","reviewerContactId","decision","note","reviewedAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"reviewerContactId":{"type":"string"},"decision":{"type":"string","enum":["Approved","Changes requested"]},"note":{"type":"string"},"reviewedAt":{"type":"string"}},"description":"An internal decision recorded by a named reviewer.","additionalProperties":false},"DeveloperComplianceWorkspaceReadQuestionnaireAnswer":{"type":"object","required":["title","answer","scope","ownerContactId","id","createdAt","updatedAt"],"properties":{"title":{"type":"string"},"answer":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"},"id":{"type":"string","description":"Stable record identifier."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"description":"A saved library entry, independent of answers already copied into requests.","additionalProperties":false},"DeveloperComplianceWorkspaceReadRiskRecord":{"type":"object","required":["id","title","category","likelihood","impact","inherent","residual","owner","initials","treatment","status","updated","description","actions","controls","activity"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"category":{"type":"string"},"likelihood":{"type":"number"},"impact":{"type":"number"},"inherent":{"type":"number"},"residual":{"type":"number"},"owner":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"initials":{"type":"string"},"treatment":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"},"description":{"type":"string"},"actions":{"type":"array","items":{"type":"string"}},"completedActions":{"type":"array","items":{"type":"string"}},"controls":{"type":"array","items":{"type":"string"}},"activity":{"type":"array","items":{"type":"string"}}},"description":"A risk tracked by the Compliance product.","additionalProperties":false},"DeveloperComplianceWorkspaceReadSupplierRecord":{"type":"object","required":["id","name","mark","location","category","service","access","criticality","risk","assessment","review","owner","contact","email","lastAssessment","risks","brand"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"mark":{"type":"string"},"location":{"type":"string"},"category":{"type":"string"},"service":{"type":"string"},"access":{"type":"string"},"criticality":{"type":"string"},"risk":{"type":"string"},"assessment":{"type":"string"},"review":{"type":"string"},"owner":{"type":"string"},"ownerContactId":{"type":"string"},"contactId":{"type":"string"},"linkedRiskIds":{"type":"array","items":{"type":"string"}},"assessmentChecks":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadSupplierAssessmentCheck"}},"documents":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadSupplierDocument"}},"notes":{"type":"string"},"contact":{"type":"string"},"email":{"type":"string"},"lastAssessment":{"type":"string"},"risks":{"type":"array","items":{"type":"string"}},"brand":{"type":"string"},"logo":{"type":["object","null"],"oneOf":[{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceAttachmentMetadata"},{"type":"null"}],"description":"Optional logo; absent legacy profiles continue to display their initials."},"questionnaireSchedule":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadQuestionnaireSchedule"}},"description":"A supplier record in the Compliance workspace.","additionalProperties":false},"DeveloperComplianceWorkspaceReadSupplierAssessmentCheck":{"type":"object","required":["id","title","response","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"response":{"type":"string","enum":["Not reviewed","Yes","No"]},"notes":{"type":"string"},"supportingContactId":{"type":"string","description":"Contact in this Space who can substantiate this answer."},"supportingSupplierContact":{"type":"string","description":"Supplier contact details recorded with this answer."},"supportingEvidenceId":{"type":"string","description":"Evidence record in this Space containing the supporting document."},"supportingUrl":{"type":"string","description":"Private HTTPS reference for this item."}},"description":"An assessment response recorded for a supplier.","additionalProperties":false},"DeveloperComplianceWorkspaceReadSupplierDocument":{"type":"object","required":["id","name","status","expiresOn","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"status":{"type":"string"},"expiresOn":{"type":"string"},"notes":{"type":"string"}},"description":"Document metadata tracked during supplier assessment.","additionalProperties":false},"DeveloperComplianceWorkspaceReadQuestionnaireSchedule":{"type":"object","required":["mode","firstSendDate","intervalMonths","responseWindowDays","reminderDays"],"properties":{"mode":{"type":"string","enum":["Manual","One-off","Recurring"]},"firstSendDate":{"type":"string"},"intervalMonths":{"type":["number","null"]},"responseWindowDays":{"type":"number"},"reminderDays":{"type":"array","items":{"type":"number"}}},"description":"A supplier's planned cadence. This record neither schedules nor sends anything.","additionalProperties":false},"DeveloperComplianceWorkspaceReadIncidentRecord":{"type":"object","required":["id","title","severity","status","systems","owner","ownerContactId","reportedAt","reported","description","postmortem","tasks","timeline"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"systems":{"type":"string"},"owner":{"type":"string"},"ownerContactId":{"type":"string"},"reportedAt":{"type":"string"},"reported":{"type":"string"},"description":{"type":"string"},"postmortem":{"type":"string"},"tasks":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadIncidentTask"}},"timeline":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceReadIncidentEvent"}}},"description":"Incident data owned by the Compliance frontend.","additionalProperties":false},"DeveloperComplianceWorkspaceReadIncidentTask":{"type":"object","required":["id","ownerContactId","title","owner","done"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"ownerContactId":{"type":"string"},"title":{"type":"string"},"owner":{"type":"string"},"done":{"type":"boolean"}},"description":"A local incident response task.","additionalProperties":false},"DeveloperComplianceWorkspaceReadIncidentEvent":{"type":"object","required":["time","title","by","note","current"],"properties":{"time":{"type":"string"},"title":{"type":"string"},"by":{"type":"string"},"note":{"type":"string"},"current":{"type":"boolean"}},"description":"An event in the demonstration incident timeline.","additionalProperties":false},"DeveloperComplianceWorkspaceReadTrainingAssignment":{"type":"object","required":["id","contactId","courseId","dueDate","progress","acknowledgedPolicyIds","reminderCount","lastReminderAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"contactId":{"type":"string"},"courseId":{"type":"string"},"dueDate":{"type":"string"},"progress":{"type":"number"},"completionProof":{"type":"string","description":"Certificate link or completion reference, up to 1,000 characters."},"acknowledgedPolicyIds":{"type":"array","items":{"type":"string"}},"reminderCount":{"type":"number"},"lastReminderAt":{"type":"string"}},"description":"A contact's assigned course and locally recorded completion.","additionalProperties":false},"DeveloperComplianceWorkspaceReadTrainingCourse":{"type":"object","required":["id","title","description","durationMinutes","modules"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"description":{"type":"string"},"durationMinutes":{"type":"number"},"modules":{"type":"array","items":{"type":"string"}}},"description":"A course that can be assigned to a workspace contact.","additionalProperties":false},"DeveloperComplianceWorkspaceReadTrainingPolicy":{"type":"object","required":["id","title","description"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"description":{"type":"string"}},"description":"A policy whose acknowledgment is tracked alongside a course.","additionalProperties":false},"DeveloperComplianceWorkspaceReadTrustCertification":{"type":"object","required":["id","title","issuer","reference","expiryDate","status","gated","ownerContactId","owner","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"issuer":{"type":"string"},"reference":{"type":"string"},"expiryDate":{"type":"string"},"status":{"type":"string","enum":["Draft","Current","Suspended","Withdrawn","Expired","Verified"]},"gated":{"type":"boolean"},"ownerContactId":{"type":"string"},"owner":{"type":"string"},"notes":{"type":"string"},"assuranceKind":{"type":"string","enum":["Certification","Attestation report","Self-assessment"],"description":"Unset for older assurance records until an owner classifies them."},"standardEdition":{"type":"string","description":"Standard edition, scheme or assessment criteria named in the artifact."},"issuedOn":{"type":"string","description":"Date the certificate or report was issued, or the assessment was recorded."},"verificationUrl":{"type":"string","description":"Internal link to the source used to verify a certificate."},"nextMilestone":{"type":"string","enum":["Define scope and prepare","Internal readiness review","Stage 1 audit","Stage 2 audit","Certification decision","Surveillance audit","Recertification audit","Other follow-up"],"description":"Next planned certification milestone."},"scope":{"type":"string","description":"Internal context on covered services, entities, locations or report periods."},"nextReviewDate":{"type":"string","description":"Planned internal review, surveillance or report follow-up."},"reportStartDate":{"type":"string","description":"Start of an attestation's observation period, when known."},"reportEndDate":{"type":"string","description":"Attestation's as-of date or final day of observation."}},"description":"An assurance artifact maintained by the security team.","additionalProperties":false},"DeveloperComplianceWorkspaceReadTrustDocument":{"type":"object","required":["id","title","description","gated","ownerContactId","owner","content","attachment","updatedAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"description":{"type":"string"},"gated":{"type":"boolean"},"ownerContactId":{"type":"string"},"owner":{"type":"string"},"content":{"type":"string"},"attachment":{"type":["object","null"],"oneOf":[{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceAttachmentMetadata"},{"type":"null"}]},"updatedAt":{"type":"string"}},"description":"A downloadable security document and its controlled visibility.","additionalProperties":false},"DeveloperComplianceWorkspaceReadTrustSubprocessor":{"type":"object","required":["id","name","purpose","region","website","ownerContactId","owner","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"purpose":{"type":"string"},"region":{"type":"string"},"website":{"type":"string"},"ownerContactId":{"type":"string"},"owner":{"type":"string"},"notes":{"type":"string"}},"description":"An organization processing data on behalf of the workspace.","additionalProperties":false},"DeveloperComplianceWorkspaceReadTrustAccessRequest":{"type":"object","required":["id","email","company","documentId","documentTitle","reason","reviewerContactId","reviewer","reviewNote","status","createdAt","reviewedAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"email":{"type":"string"},"company":{"type":"string"},"documentId":{"type":"string"},"documentTitle":{"type":"string"},"reason":{"type":"string"},"reviewerContactId":{"type":"string"},"reviewer":{"type":"string"},"reviewNote":{"type":"string"},"status":{"type":"string","enum":["Pending","Approved","Rejected"]},"createdAt":{"type":"string"},"reviewedAt":{"type":["string","null"]}},"description":"A saved request to disclose a document or the security package.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteCollections":{"type":"object","required":["compliance:contacts","compliance:controls","compliance:evidence","compliance:statements-of-applicability","compliance:questionnaires","compliance:questionnaire-answers","compliance:risks","compliance:suppliers","compliance:incidents","compliance:training","compliance:training-courses","compliance:training-policies","compliance:trust:certifications","compliance:trust:documents","compliance:trust:subprocessors","compliance:trust:access-requests"],"properties":{"compliance:contacts":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteContactRecord"},"maxItems":2000},"compliance:controls":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteControl"},"maxItems":2000},"compliance:evidence":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteEvidence"},"maxItems":2000},"compliance:statements-of-applicability":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteStatementOfApplicability"},"maxItems":2000},"compliance:questionnaires":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireCase"},"maxItems":2000},"compliance:questionnaire-answers":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireAnswer"},"maxItems":2000},"compliance:risks":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteRiskRecord"},"maxItems":2000},"compliance:suppliers":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSupplierRecord"},"maxItems":2000},"compliance:incidents":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteIncidentRecord"},"maxItems":2000},"compliance:training":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteTrainingAssignment"},"maxItems":2000},"compliance:training-courses":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteTrainingCourse"},"maxItems":2000},"compliance:training-policies":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteTrainingPolicy"},"maxItems":2000},"compliance:trust:certifications":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteTrustCertification"},"maxItems":2000},"compliance:trust:documents":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteTrustDocument"},"maxItems":2000},"compliance:trust:subprocessors":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteTrustSubprocessor"},"maxItems":2000},"compliance:trust:access-requests":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteTrustAccessRequest"},"maxItems":2000}},"description":"Workspace records keyed by stable collection IDs shared with schema v1 backups.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteContactRecord":{"type":"object","required":["id","name","email","department","role","status","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"email":{"type":"string"},"department":{"type":"string"},"role":{"type":"string","description":"Job role from Space member management."},"status":{"type":"string","enum":["Active","Inactive"]},"notes":{"type":"string"},"avatarUrl":{"type":"string","description":"Optional image URL retained on a historical contact."}},"description":"A person who can own records or receive a training assignment.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteControl":{"type":"object","required":["id","title","frameworks","ownerContactId","status","dueDate","description","owner","updated","activity"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"frameworks":{"type":"array","items":{"type":"string"}},"ownerContactId":{"type":"string"},"status":{"type":"string"},"dueDate":{"type":"string"},"description":{"type":"string"},"requirementMappings":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteControlRequirementMapping"}},"templateId":{"type":"string"},"owner":{"type":"string"},"updated":{"type":"string"},"activity":{"type":"array","items":{"type":"string"}}},"description":"Persisted control, including accountable owner and activity history.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteControlRequirementMapping":{"type":"object","required":["framework","reference"],"properties":{"framework":{"type":"string"},"reference":{"type":"string"},"sourceVersion":{"type":"string"},"scope":{"type":"string"}},"description":"Workspace-authored traceability from a control to references in a framework.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteEvidence":{"type":"object","required":["name","controlId","ownerContactId","dueDate","description","sourceUrl","id","owner","status","date","requestedAt","submittedAt","reviewedAt","reviewedByContactId","reviewNotes"],"properties":{"evidenceKind":{"type":"string","enum":["Period-based","Point-in-time","Standing document"]},"collectedOn":{"type":"string"},"coverageStart":{"type":"string"},"coverageEnd":{"type":"string"},"renewalDate":{"type":"string"},"sourceSystem":{"type":"string"},"acceptanceCriteria":{"type":"string"},"additionalControlIds":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"controlId":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"description":{"type":"string"},"sourceUrl":{"type":"string"},"attachment":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceAttachmentInput"},"id":{"type":"string","description":"Stable record identifier."},"owner":{"type":"string"},"status":{"type":"string"},"date":{"type":"string"},"requestedAt":{"type":"string"},"submittedAt":{"type":"string"},"reviewedAt":{"type":"string"},"reviewedByContactId":{"type":"string"},"reviewNotes":{"type":"string"},"reviewHistory":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteEvidenceReviewDecision"}}},"description":"Evidence requests and submissions share one reviewable record.","additionalProperties":false},"DeveloperComplianceWorkspaceAttachmentInput":{"oneOf":[{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceAttachmentMetadata"},{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceUpload"}]},"DeveloperComplianceWorkspaceUpload":{"type":"object","required":["id","name","mimeType","size","dataUrl"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"mimeType":{"type":"string"},"size":{"type":"integer","minimum":0,"maximum":1000000},"dataUrl":{"type":"string","description":"Base64 data URL with the original file media type."}},"additionalProperties":false,"description":"New file with a base64 data URL. Dashio assigns a fresh stored attachment ID. Maximum 1 MB per file; the Space upload allowance also applies."},"DeveloperComplianceWorkspaceWriteEvidenceReviewDecision":{"type":"object","required":["reviewedAt","reviewedByContactId","status","reviewNotes"],"properties":{"reviewedAt":{"type":"string"},"reviewedByContactId":{"type":"string"},"status":{"type":"string","enum":["Verified","Changes requested"]},"reviewNotes":{"type":"string"}},"description":"An actual internal review decision retained when evidence is revised or resubmitted.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteStatementOfApplicability":{"type":"object","required":["title","scope","sourceEdition","annexAReviewed","id","entries","revisions"],"properties":{"title":{"type":"string"},"scope":{"type":"string"},"sourceEdition":{"type":"string"},"annexAReviewed":{"type":"boolean"},"id":{"type":"string","description":"Stable record identifier."},"entries":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSoaEntry"}},"revisions":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSoaRevision"}}},"description":"A scoped statement with an editable draft and recorded revision history.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteSoaEntry":{"type":"object","required":["kind","reference","title","decision","rationale","implementation","controlId","id"],"properties":{"kind":{"type":"string","enum":["Annex A reference","Organization control"]},"reference":{"type":"string"},"title":{"type":"string"},"decision":{"type":"string","enum":["Unassessed","Included","Excluded"]},"rationale":{"type":"string"},"implementation":{"type":"string","enum":["Not assessed","Not started","In progress","Implemented"]},"controlId":{"type":"string"},"id":{"type":"string","description":"Stable record identifier."}},"description":"An identified row of the current statement.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteSoaRevision":{"type":"object","required":["title","scope","sourceEdition","annexAReviewed","number","recordedAt","note","entries"],"properties":{"title":{"type":"string"},"scope":{"type":"string"},"sourceEdition":{"type":"string"},"annexAReviewed":{"type":"boolean"},"number":{"type":"number"},"recordedAt":{"type":"string"},"note":{"type":"string"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSoaRevisionEntry"}}},"description":"A recorded copy of a statement at a point in time.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteSoaRevisionEntry":{"type":"object","required":["kind","reference","title","decision","rationale","implementation","controlId","id"],"properties":{"kind":{"type":"string","enum":["Annex A reference","Organization control"]},"reference":{"type":"string"},"title":{"type":"string"},"decision":{"type":"string","enum":["Unassessed","Included","Excluded"]},"rationale":{"type":"string"},"implementation":{"type":"string","enum":["Not assessed","Not started","In progress","Implemented"]},"controlId":{"type":"string"},"id":{"type":"string","description":"Stable record identifier."},"linkedControlTitle":{"type":"string"}},"description":"A historical row can retain the control name as recorded.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteQuestionnaireCase":{"type":"object","required":["title","counterparty","scope","ownerContactId","supplierId","dueDate","sourceUrl","direction","id","status","questions","artifacts","reviews","createdAt","updatedAt"],"properties":{"supplierReviewId":{"type":"string","format":"uuid","description":"Private navigation reference to the supplier review that prepared this questionnaire."},"title":{"type":"string"},"counterparty":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"},"supplierId":{"type":"string"},"dueDate":{"type":"string"},"sourceUrl":{"type":"string"},"direction":{"type":"string","enum":["Customer response","Supplier assessment"]},"serviceType":{"type":"string","enum":["Software","Cloud service","Professional services","Other"]},"id":{"type":"string","description":"Stable record identifier."},"status":{"type":"string","enum":["Draft","In review","Changes requested","Approved","Completed"]},"questions":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireQuestion"}},"artifacts":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireArtifact"}},"reviews":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireReview"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"description":"A working case with independently identified items and review events.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteQuestionnaireQuestion":{"type":"object","required":["prompt","answer","required","reusableAnswerId","id"],"properties":{"prompt":{"type":"string"},"answer":{"type":"string"},"required":{"type":"boolean"},"reusableAnswerId":{"type":"string"},"supportingContactId":{"type":"string","description":"Contact in this Space who can substantiate this answer."},"supportingSupplierContact":{"type":"string","description":"Supplier contact details recorded with this answer."},"supportingEvidenceId":{"type":"string","description":"Evidence record in this Space containing the supporting document."},"supportingUrl":{"type":"string","description":"Private HTTPS reference for this item."},"id":{"type":"string","description":"Stable record identifier."}},"description":"An identified question and its case-specific answer.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteQuestionnaireArtifact":{"type":"object","required":["title","kind","scope","url","required","id"],"properties":{"title":{"type":"string"},"kind":{"type":"string","enum":["ISO 27001 certificate","Statement of Applicability","SBOM","Security policy","Other"]},"scope":{"type":"string"},"url":{"type":"string"},"required":{"type":"boolean"},"handoffNote":{"type":"string","description":"Internal location or handoff note when no link can be recorded."},"id":{"type":"string","description":"Stable record identifier."}},"description":"An identified artifact request within one case.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteQuestionnaireReview":{"type":"object","required":["id","reviewerContactId","decision","note","reviewedAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"reviewerContactId":{"type":"string"},"decision":{"type":"string","enum":["Approved","Changes requested"]},"note":{"type":"string"},"reviewedAt":{"type":"string"}},"description":"An internal decision recorded by a named reviewer.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteQuestionnaireAnswer":{"type":"object","required":["title","answer","scope","ownerContactId","id","createdAt","updatedAt"],"properties":{"title":{"type":"string"},"answer":{"type":"string"},"scope":{"type":"string"},"ownerContactId":{"type":"string"},"id":{"type":"string","description":"Stable record identifier."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"description":"A saved library entry, independent of answers already copied into requests.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteRiskRecord":{"type":"object","required":["id","title","category","likelihood","impact","inherent","residual","owner","initials","treatment","status","updated","description","actions","controls","activity"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"category":{"type":"string"},"likelihood":{"type":"number"},"impact":{"type":"number"},"inherent":{"type":"number"},"residual":{"type":"number"},"owner":{"type":"string"},"ownerContactId":{"type":"string"},"dueDate":{"type":"string"},"initials":{"type":"string"},"treatment":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"},"description":{"type":"string"},"actions":{"type":"array","items":{"type":"string"}},"completedActions":{"type":"array","items":{"type":"string"}},"controls":{"type":"array","items":{"type":"string"}},"activity":{"type":"array","items":{"type":"string"}}},"description":"A risk tracked by the Compliance product.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteSupplierRecord":{"type":"object","required":["id","name","mark","location","category","service","access","criticality","risk","assessment","review","owner","contact","email","lastAssessment","risks","brand"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"mark":{"type":"string"},"location":{"type":"string"},"category":{"type":"string"},"service":{"type":"string"},"access":{"type":"string"},"criticality":{"type":"string"},"risk":{"type":"string"},"assessment":{"type":"string"},"review":{"type":"string"},"owner":{"type":"string"},"ownerContactId":{"type":"string"},"contactId":{"type":"string"},"linkedRiskIds":{"type":"array","items":{"type":"string"}},"assessmentChecks":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSupplierAssessmentCheck"}},"documents":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteSupplierDocument"}},"notes":{"type":"string"},"contact":{"type":"string"},"email":{"type":"string"},"lastAssessment":{"type":"string"},"risks":{"type":"array","items":{"type":"string"}},"brand":{"type":"string"},"logo":{"type":["object","null"],"oneOf":[{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceAttachmentInput"},{"type":"null"}],"description":"Optional logo; absent legacy profiles continue to display their initials."},"questionnaireSchedule":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteQuestionnaireSchedule"}},"description":"A supplier record in the Compliance workspace.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteSupplierAssessmentCheck":{"type":"object","required":["id","title","response","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"response":{"type":"string","enum":["Not reviewed","Yes","No"]},"notes":{"type":"string"},"supportingContactId":{"type":"string","description":"Contact in this Space who can substantiate this answer."},"supportingSupplierContact":{"type":"string","description":"Supplier contact details recorded with this answer."},"supportingEvidenceId":{"type":"string","description":"Evidence record in this Space containing the supporting document."},"supportingUrl":{"type":"string","description":"Private HTTPS reference for this item."}},"description":"An assessment response recorded for a supplier.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteSupplierDocument":{"type":"object","required":["id","name","status","expiresOn","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"status":{"type":"string"},"expiresOn":{"type":"string"},"notes":{"type":"string"}},"description":"Document metadata tracked during supplier assessment.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteQuestionnaireSchedule":{"type":"object","required":["mode","firstSendDate","intervalMonths","responseWindowDays","reminderDays"],"properties":{"mode":{"type":"string","enum":["Manual","One-off","Recurring"]},"firstSendDate":{"type":"string"},"intervalMonths":{"type":["number","null"]},"responseWindowDays":{"type":"number"},"reminderDays":{"type":"array","items":{"type":"number"}}},"description":"A supplier's planned cadence. This record neither schedules nor sends anything.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteIncidentRecord":{"type":"object","required":["id","title","severity","status","systems","owner","ownerContactId","reportedAt","reported","description","postmortem","tasks","timeline"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"systems":{"type":"string"},"owner":{"type":"string"},"ownerContactId":{"type":"string"},"reportedAt":{"type":"string"},"reported":{"type":"string"},"description":{"type":"string"},"postmortem":{"type":"string"},"tasks":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteIncidentTask"}},"timeline":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceWriteIncidentEvent"}}},"description":"Incident data owned by the Compliance frontend.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteIncidentTask":{"type":"object","required":["id","ownerContactId","title","owner","done"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"ownerContactId":{"type":"string"},"title":{"type":"string"},"owner":{"type":"string"},"done":{"type":"boolean"}},"description":"A local incident response task.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteIncidentEvent":{"type":"object","required":["time","title","by","note","current"],"properties":{"time":{"type":"string"},"title":{"type":"string"},"by":{"type":"string"},"note":{"type":"string"},"current":{"type":"boolean"}},"description":"An event in the demonstration incident timeline.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteTrainingAssignment":{"type":"object","required":["id","contactId","courseId","dueDate","progress","acknowledgedPolicyIds","reminderCount","lastReminderAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"contactId":{"type":"string"},"courseId":{"type":"string"},"dueDate":{"type":"string"},"progress":{"type":"number"},"completionProof":{"type":"string","description":"Certificate link or completion reference, up to 1,000 characters."},"acknowledgedPolicyIds":{"type":"array","items":{"type":"string"}},"reminderCount":{"type":"number"},"lastReminderAt":{"type":"string"}},"description":"A contact's assigned course and locally recorded completion.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteTrainingCourse":{"type":"object","required":["id","title","description","durationMinutes","modules"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"description":{"type":"string"},"durationMinutes":{"type":"number"},"modules":{"type":"array","items":{"type":"string"}}},"description":"A course that can be assigned to a workspace contact.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteTrainingPolicy":{"type":"object","required":["id","title","description"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"description":{"type":"string"}},"description":"A policy whose acknowledgment is tracked alongside a course.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteTrustCertification":{"type":"object","required":["id","title","issuer","reference","expiryDate","status","gated","ownerContactId","owner","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"issuer":{"type":"string"},"reference":{"type":"string"},"expiryDate":{"type":"string"},"status":{"type":"string","enum":["Draft","Current","Suspended","Withdrawn","Expired","Verified"]},"gated":{"type":"boolean"},"ownerContactId":{"type":"string"},"owner":{"type":"string"},"notes":{"type":"string"},"assuranceKind":{"type":"string","enum":["Certification","Attestation report","Self-assessment"],"description":"Unset for older assurance records until an owner classifies them."},"standardEdition":{"type":"string","description":"Standard edition, scheme or assessment criteria named in the artifact."},"issuedOn":{"type":"string","description":"Date the certificate or report was issued, or the assessment was recorded."},"verificationUrl":{"type":"string","description":"Internal link to the source used to verify a certificate."},"nextMilestone":{"type":"string","enum":["Define scope and prepare","Internal readiness review","Stage 1 audit","Stage 2 audit","Certification decision","Surveillance audit","Recertification audit","Other follow-up"],"description":"Next planned certification milestone."},"scope":{"type":"string","description":"Internal context on covered services, entities, locations or report periods."},"nextReviewDate":{"type":"string","description":"Planned internal review, surveillance or report follow-up."},"reportStartDate":{"type":"string","description":"Start of an attestation's observation period, when known."},"reportEndDate":{"type":"string","description":"Attestation's as-of date or final day of observation."}},"description":"An assurance artifact maintained by the security team.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteTrustDocument":{"type":"object","required":["id","title","description","gated","ownerContactId","owner","content","attachment","updatedAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"title":{"type":"string"},"description":{"type":"string"},"gated":{"type":"boolean"},"ownerContactId":{"type":"string"},"owner":{"type":"string"},"content":{"type":"string"},"attachment":{"type":["object","null"],"oneOf":[{"$ref":"#/components/schemas/DeveloperComplianceWorkspaceAttachmentInput"},{"type":"null"}]},"updatedAt":{"type":"string"}},"description":"A downloadable security document and its controlled visibility.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteTrustSubprocessor":{"type":"object","required":["id","name","purpose","region","website","ownerContactId","owner","notes"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"name":{"type":"string"},"purpose":{"type":"string"},"region":{"type":"string"},"website":{"type":"string"},"ownerContactId":{"type":"string"},"owner":{"type":"string"},"notes":{"type":"string"}},"description":"An organization processing data on behalf of the workspace.","additionalProperties":false},"DeveloperComplianceWorkspaceWriteTrustAccessRequest":{"type":"object","required":["id","email","company","documentId","documentTitle","reason","reviewerContactId","reviewer","reviewNote","status","createdAt","reviewedAt"],"properties":{"id":{"type":"string","description":"Stable record identifier."},"email":{"type":"string"},"company":{"type":"string"},"documentId":{"type":"string"},"documentTitle":{"type":"string"},"reason":{"type":"string"},"reviewerContactId":{"type":"string"},"reviewer":{"type":"string"},"reviewNote":{"type":"string"},"status":{"type":"string","enum":["Pending","Approved","Rejected"]},"createdAt":{"type":"string"},"reviewedAt":{"type":["string","null"]}},"description":"A saved request to disclose a document or the security package.","additionalProperties":false}},"headers":{"DeveloperDomainAuditLocation":{"description":"Relative URL to poll the current audit status.","required":true,"schema":{"type":"string","format":"uri-reference"}},"DeveloperDomainAuditReplay":{"description":"Present as true when returning the original acceptance receipt for the supplied key.","schema":{"type":"string","const":"true"}}}}}