{"openapi":"3.1.0","info":{"title":"Summer API","version":"2026-10-20","description":"Summer's company setup and case API. Separate from any customer's own API. Never available to any grant: Approving a business effect, outgoing customer message or plan execution; Revealing a saved credential value; Approving Summer platform access requests; Ownership transfer and owner/admin role grants; Raising model or assistant spending limits; Identity-verification attestations and clinical directions."},"servers":[{"url":"https://api.gosummer.ai/v1"}],"paths":{"/me":{"get":{"operationId":"account.me","summary":"Show the signed-in person, Summer access status and this connection's grant.","tags":["account"],"x-summer-ownership":"user","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[],"security":[{"summer":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies":{"get":{"operationId":"account.companies.list","summary":"List companies the person can access and whether this connection includes each one.","tags":["account"],"x-summer-ownership":"user","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[],"security":[{"summer":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/access-request":{"get":{"operationId":"account.access_request.read","summary":"Read the person's Summer access request. Approval is a separate Summer team decision.","tags":["account"],"x-summer-ownership":"user","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[],"security":[{"summer":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"account.access_request.submit","summary":"Submit or update a Summer access request. This cannot approve access.","tags":["account"],"x-summer-ownership":"user","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"company_name":{"type":"string","minLength":1,"maxLength":120},"note":{"type":"string","maxLength":2000}},"required":["company_name","note"],"additionalProperties":false}}}},"security":[{"summer":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/invitations/accept":{"post":{"operationId":"account.invitation.accept","summary":"Accept a company invitation sent to this person. Authorize again to add the company to a connection.","tags":["account"],"x-summer-ownership":"user","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"none","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"token":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"}},"required":["token"],"additionalProperties":false}}}},"security":[{"summer":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/connections":{"get":{"operationId":"account.connections.list","summary":"List this person's agent connections, grants, last use and expiry.","tags":["account"],"x-summer-ownership":"user","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[],"security":[{"summer":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/connections/{connection}/revoke":{"post":{"operationId":"account.connections.revoke","summary":"Revoke one of this person's agent connections immediately.","tags":["account"],"x-summer-ownership":"user","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"connection","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reason":{"type":"string","maxLength":200}},"additionalProperties":false}}}},"security":[{"summer":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides":{"get":{"operationId":"guides.get","summary":"Read the company's editable guidebook, draft articles, assets and publication state. Customer guides share the existing company knowledge source.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]},{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"put":{"operationId":"guides.save","summary":"Create or edit guidebook details at the expected version. Saves a private draft; does not publish.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1,"maxLength":160},"description":{"type":"string","maxLength":1000},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"hero_background":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"portal_url":{"anyOf":[{"type":"string","const":""},{"type":"string","maxLength":1000,"format":"uri"}]},"logo_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["slug","title","description","accent","portal_url"],"additionalProperties":false},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["expected_version","settings","reason"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/articles/{article}":{"get":{"operationId":"guides.articles.get","summary":"Read an editable guide article and its current knowledge revision.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"article","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"put":{"operationId":"guides.articles.save","summary":"Create or edit a Markdown customer article with source references and managed asset IDs. Saves a draft in the shared knowledge library; later edits do not change a published release.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"article","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1,"maxLength":160},"summary":{"type":"string","maxLength":1000},"topic":{"type":"string","minLength":1,"maxLength":100},"content":{"type":"string","minLength":1,"maxLength":500000},"asset_ids":{"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"source_url":{"anyOf":[{"type":"string","const":""},{"type":"string","maxLength":1000,"format":"uri"}]},"verified_at":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["expected_revision","slug","title","summary","topic","content","asset_ids","source_url","reason"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/preview":{"get":{"operationId":"guides.preview","summary":"Read the exact current draft, article revisions and authenticated preview URL before publishing. No public access token is issued.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]},{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/authoring":{"get":{"operationId":"guides.authoring","summary":"Get the reviewed company-specific guide-building instructions for your native coding agent. It uses its own authorized writing, screenshot, image and video tools, then Summer's upload and publication APIs. No model run or customer effect starts from this read.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/publish":{"post":{"operationId":"guides.publish","summary":"Publish the exact selected article revisions and ready media to the company's customer help center. Requires explicit publication authority; does not approve customer business actions.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991},"articles":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","revision"],"additionalProperties":false}},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["expected_version","articles","reason"],"additionalProperties":false}}}},"security":[{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/unpublish":{"post":{"operationId":"guides.unpublish","summary":"Remove the company's guide and release media from Summer's public serving path at the expected version. Downloaded copies cannot be recalled.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["expected_version","reason"],"additionalProperties":false}}}},"security":[{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/history":{"get":{"operationId":"guides.history","summary":"Read the company's guide edits, upload and publication history.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]},{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/hosting":{"get":{"operationId":"guides.hosting.get","summary":"Read the optional custom guide domain, DNS instructions and verified HTTPS status. Summer-hosted guide URLs need no customer DNS setup.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]},{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"put":{"operationId":"guides.hosting.save","summary":"Save or remove a custom guide hostname at the expected version. Saving a name does not verify ownership or provision HTTPS.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991},"hostname":{"anyOf":[{"type":"string","pattern":"^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z][a-z0-9-]{1,62}$"},{"type":"null"}]}},"required":["expected_version","hostname"],"additionalProperties":false}}}},"security":[{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guides/hosting/verify":{"post":{"operationId":"guides.hosting.verify","summary":"Check the saved domain's DNS ownership, attach it through Summer's hosting connection and verify HTTPS. Returns pending until each check succeeds.","tags":["guides"],"x-summer-ownership":"company","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expected_version"],"additionalProperties":false}}}},"security":[{"summer":["guides.publish"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guide-assets":{"get":{"operationId":"assets.list","summary":"List the company's private guide media, metadata and upload status. Uploading does not make a file public.","tags":["assets"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"assets.uploads.create","summary":"Start or recover a private resumable Markdown, image, video, PDF or caption upload from metadata. Transfer file bytes with the trusted local Summer CLI; the hosted MCP server cannot read local paths.","tags":["assets"],"x-summer-ownership":"company","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"filename":{"type":"string","minLength":1,"maxLength":200},"media_type":{"type":"string","enum":["text/markdown","image/png","image/jpeg","image/webp","image/gif","video/mp4","video/webm","text/vtt","application/pdf"]},"byte_length":{"type":"integer","minimum":1,"maximum":268435456},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"alt_text":{"type":"string","maxLength":500},"caption":{"type":"string","maxLength":2000},"provenance":{"type":"string","minLength":1,"maxLength":2000},"transcript":{"default":"","type":"string","maxLength":100000},"poster_asset_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","filename","media_type","byte_length","sha256","alt_text","caption","provenance"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guide-assets/{asset}":{"get":{"operationId":"assets.get","summary":"Read one guide asset, checksum and resumable chunk receipts. No secret upload capability is returned.","tags":["assets"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"asset","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"patch":{"operationId":"assets.edit","summary":"Edit guide media captions, alt text, provenance, transcript or poster at the expected version, or retire unused media. Published releases keep their pinned metadata.","tags":["assets"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"asset","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","maxLength":500},"caption":{"type":"string","maxLength":2000},"provenance":{"type":"string","minLength":1,"maxLength":2000},"transcript":{"default":"","type":"string","maxLength":100000},"poster_asset_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"retired":{"default":false,"type":"boolean"},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["expected_version","alt_text","caption","provenance","reason"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guide-assets/{asset}/chunks/{index}":{"put":{"operationId":"assets.uploads.write","summary":"Transfer one immutable file chunk of at most 2 MiB as application/octet-stream with the local CLI's Summer token. Never pass binary or base64 file bodies through MCP.","tags":["assets"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"none","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"asset","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"index","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","minimum":0,"maximum":127}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary","maxLength":2097152}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/guide-assets/{asset}/complete":{"post":{"operationId":"assets.uploads.complete","summary":"Verify the original size, content signature and SHA-256 against saved private bytes, then mark a guide upload ready. A ready file remains private until published in a guide.","tags":["assets"],"x-summer-ownership":"company","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"asset","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/capabilities":{"get":{"operationId":"company.capabilities","summary":"What this connection can do here, with a reason for everything unavailable.","tags":["company"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["setup"]},{"summer":["capabilities.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/setup":{"get":{"operationId":"company.setup_status","summary":"Saved, verified, pending, unavailable and enabled state for each setup item.","tags":["company"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["setup"]},{"summer":["capabilities.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/capability-checks":{"get":{"operationId":"capability_checks.list","summary":"Read the same operational capability checklist, results, discovery paths and review history shown in Summer. Every usable API, browser or knowledge path can count.","tags":["capability_checks"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["capabilities.read"]},{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/capability-checks/{capability}":{"get":{"operationId":"capability_checks.get","summary":"Read one capability, its concrete test, evidence and latest 20 review records.","tags":["capability_checks"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"capability","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[a-z][a-z0-9_]{1,79}$"}}],"security":[{"summer":["capabilities.read"]},{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"put":{"operationId":"capability_checks.save","summary":"Edit a capability expectation or add a business-specific custom_ capability with a reason. Resets its result and retains history. Does not create a provider tool or grant execution access.","tags":["capability_checks"],"x-summer-ownership":"environment","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"capability","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[a-z][a-z0-9_]{1,79}$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"},"definition":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,79}$"},"title":{"type":"string","minLength":1,"maxLength":120},"group":{"type":"string","minLength":1,"maxLength":80},"mode":{"type":"string","enum":["read","approval"]},"expectation":{"type":"string","minLength":1,"maxLength":700},"test":{"type":"string","minLength":1,"maxLength":1000},"examples":{"type":"string","maxLength":300}},"required":["id","title","group","mode","expectation","test","examples"],"additionalProperties":false},"notes":{"type":"string","minLength":1,"maxLength":2000}},"required":["expected_version","definition","notes"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/capability-checks/{capability}/reports":{"post":{"operationId":"capability_checks.report","summary":"Record the setup agent's capability assessment with original evidence and the path Summer can discover and use. A pass needs evidence and a discovery path. Reports are labeled as agent-reported, never human approval or independently verified execution.","tags":["capability_checks"],"x-summer-ownership":"environment","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"capability","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[a-z][a-z0-9_]{1,79}$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"},"state":{"type":"string","enum":["not_checked","passed","failed","blocked","not_applicable"]},"notes":{"type":"string","minLength":1,"maxLength":2000},"evidence":{"type":"string","maxLength":2000},"fulfillment":{"type":"object","properties":{"kind":{"type":"string","enum":["api","browser","knowledge","other","combined"]},"discovery":{"type":"string","minLength":1,"maxLength":1000,"description":"How Summer can discover this path"},"location":{"type":"string","minLength":1,"maxLength":1000,"description":"Guide, tool, API documentation or portal location; never a secret"}},"required":["kind","discovery","location"],"additionalProperties":false}},"required":["expected_version","state","notes","evidence"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/capability-checks/{capability}/tests":{"post":{"operationId":"capability_checks.test","summary":"Request a read-only Summer capability test on an authorized sample case. Also needs investigations.request and current runtime access. Does not approve or execute customer changes.","tags":["capability_checks"],"x-summer-ownership":"environment","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"capability","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[a-z][a-z0-9_]{1,79}$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"},"case_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["expected_version","case_id"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/settings":{"get":{"operationId":"company.settings.read","summary":"Read company-wide settings. Changes affect every environment.","tags":["company"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"patch":{"operationId":"company.settings.update","summary":"Update company-wide settings with the expected version. Affects every environment.","tags":["company"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"timezone":{"type":"string","maxLength":100},"workflow":{"type":"string","enum":["support","order_status","billing","custom"]},"note":{"type":"string","maxLength":1000},"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"}},"required":["name","timezone","workflow","note","expected_version"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/integrations":{"get":{"operationId":"integrations.list","summary":"List provider integrations, their required fields and saved metadata. Never returns values.","tags":["integrations"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/integrations/{integration}":{"put":{"operationId":"integrations.save","summary":"Define a custom integration's credential names and labels. No secret values. Saving a definition does not establish runtime access; upload secrets through the local CLI and verify an agent-usable path.","tags":["integrations"],"x-summer-ownership":"environment","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"integration","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^custom-[a-z0-9-]{1,64}$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"},"name":{"type":"string","minLength":1,"maxLength":100},"fields":{"minItems":1,"maxItems":128,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{0,127}$","description":"Credential variable name, for example STRIPE_READ_KEY"},"label":{"type":"string","minLength":1,"maxLength":100},"required":{"type":"boolean"}},"required":["name","label","required"],"additionalProperties":false}}},"required":["expected_version","name","fields"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/credentials":{"get":{"operationId":"credentials.list","summary":"List saved credential names, sources and versions. Never returns values.","tags":["credentials"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/credentials/{name}":{"put":{"operationId":"credentials.set","summary":"Save one selected credential value or Doppler reference. Replacing an active credential needs credentials.replace. Returns metadata only.","tags":["credentials"],"x-summer-ownership":"environment","x-summer-effect":"secret_write","x-summer-release":"A","x-summer-mcp":"handoff","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"name","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[A-Z][A-Z0-9_]{0,127}$","description":"Credential variable name, for example STRIPE_READ_KEY"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"source":{"type":"string","const":"value"},"value":{"type":"string","minLength":1,"maxLength":16384},"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"}},"required":["source","value","expected_version"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","const":"doppler"},"secret_name":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{0,127}$","description":"Credential variable name, for example STRIPE_READ_KEY"},"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"}},"required":["source","secret_name","expected_version"],"additionalProperties":false}]}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"delete":{"operationId":"credentials.remove","summary":"Remove an active credential with the expected version.","tags":["credentials"],"x-summer-ownership":"environment","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"none","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"name","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[A-Z][A-Z0-9_]{0,127}$","description":"Credential variable name, for example STRIPE_READ_KEY"}},{"name":"expected_version","in":"query","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"security":[{"summer":["credentials.replace"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/knowledge":{"get":{"operationId":"knowledge.list","summary":"List current company knowledge documents. Knowledge is company-wide, not per environment.","tags":["knowledge"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"query","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":200}},{"name":"offset","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","minimum":0,"maximum":100000}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"knowledge.create","summary":"Upload a new company knowledge document with original revision history. The shared company library is used by all roles and environments. An existing document must be read and edited instead.","tags":["knowledge"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$","description":"Knowledge document ID"},"path":{"type":"string","maxLength":240,"pattern":"^company\\/[a-z0-9][a-z0-9._/-]*\\.md$"},"content":{"type":"string","minLength":1,"maxLength":1000000},"tags":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["id","path","content","reason"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/knowledge/{document}":{"get":{"operationId":"knowledge.get","summary":"Read one company knowledge document and its current revision.","tags":["knowledge"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"document","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$","description":"Knowledge document ID"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"put":{"operationId":"knowledge.edit","summary":"Edit an existing company knowledge document with the expected revision and a reason. Affects every environment and later runs.","tags":["knowledge"],"x-summer-ownership":"company","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"document","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$","description":"Knowledge document ID"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"content":{"type":"string","minLength":1,"maxLength":1000000},"status":{"type":"string","enum":["active","retired"]},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["revision","content","status","reason"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/knowledge/{document}/history":{"get":{"operationId":"knowledge.history","summary":"Read the edit history of a company knowledge document.","tags":["knowledge"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"document","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:[.-][a-z0-9]+)*$","description":"Knowledge document ID"}},{"name":"offset","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","minimum":0,"maximum":100000}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/installations":{"get":{"operationId":"messenger.installations.list","summary":"List Messenger installations in this environment. Signing keys are never returned.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"messenger.installations.create","summary":"Create an installation with a client-chosen ID. The one-time signing key goes to the trusted local helper, never to model-visible output.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"secret_write","x-summer-release":"A","x-summer-mcp":"handoff","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}},{"name":"Summer-One-Time-Secret","in":"header","required":true,"schema":{"const":"accept"},"description":"Confirms the client writes the returned secret directly to a secret store."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"New installation ID chosen by the client, so a retry cannot create a duplicate"},"settings":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Live widget. The approved setup grant includes production installation and activation."},"guests_enabled":{"type":"boolean"},"display_name":{"type":"string","minLength":1,"maxLength":80,"description":"Company name shown in the Messenger header"},"logo_url":{"description":"Public company logo shown in the header","type":"string","maxLength":1024},"identity":{"description":"Agent name and AI disclosure. Defaults to named support with a neutral first name and last initial.","type":"object","properties":{"mode":{"default":"human","description":"Named support persona (default) or a visible AI assistant label.","type":"string","enum":["human","ai"]},"name_style":{"default":"neutral","type":"string","enum":["neutral","female"]},"custom_name":{"default":"","type":"string","maxLength":80}},"additionalProperties":false},"allowed_origins":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":256},"description":"Exact website origins, https (http://localhost allowed in staging)"},"privacy_url":{"type":"string","maxLength":512},"fallback_url":{"type":"string","maxLength":512},"office_hours":{"type":"string","maxLength":200},"presentation":{"description":"Company chat colors, welcome and chat copy, home/chat links and contact form labels. Plain text only; links use HTTPS. Scoped to this installation.","type":"object","properties":{"colors":{"default":{},"type":"object","properties":{"accent":{"default":"#a95424","type":"string","minLength":7,"maxLength":7,"pattern":"^#[0-9a-f]{6}$"},"customer_bubble":{"default":"#eef1e7","type":"string","minLength":7,"maxLength":7,"pattern":"^#[0-9a-f]{6}$"}},"additionalProperties":false},"welcome_title":{"default":"How can we help?","type":"string","minLength":1,"maxLength":100},"welcome_description":{"default":"","type":"string","maxLength":300},"chat_label":{"default":"Message support","type":"string","minLength":1,"maxLength":60},"header_description":{"default":"Support team","type":"string","minLength":1,"maxLength":100},"thread_title":{"default":"What's on your mind?","type":"string","minLength":1,"maxLength":100},"thread_description":{"default":"Ask a question here. We can help you find the next step.","type":"string","minLength":1,"maxLength":300},"actions":{"default":[{"type":"lead_capture","label":"Request follow-up","show_on_home":false,"show_in_chat":true}],"maxItems":6,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"link"},"label":{"type":"string","minLength":1,"maxLength":60},"url":{"type":"string","maxLength":1024},"show_on_home":{"type":"boolean"},"show_in_chat":{"type":"boolean"}},"required":["type","label","url","show_on_home","show_in_chat"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"lead_capture"},"label":{"type":"string","minLength":1,"maxLength":60},"show_on_home":{"type":"boolean"},"show_in_chat":{"type":"boolean"}},"required":["type","label","show_on_home","show_in_chat"],"additionalProperties":false}]}},"lead_capture":{"default":{},"type":"object","properties":{"title":{"default":"Request follow-up","type":"string","minLength":1,"maxLength":100},"description":{"default":"Leave your details so our team can contact you.","type":"string","minLength":1,"maxLength":300},"name_label":{"default":"Name","type":"string","minLength":1,"maxLength":60},"email_label":{"default":"Email","type":"string","minLength":1,"maxLength":60},"company_label":{"default":"Company","type":"string","minLength":1,"maxLength":60},"phone_label":{"default":"Phone number","type":"string","minLength":1,"maxLength":60},"show_phone":{"default":false,"type":"boolean"},"phone_required":{"default":false,"type":"boolean"},"message_label":{"default":"Message","type":"string","minLength":1,"maxLength":60},"show_message":{"default":true,"type":"boolean"},"show_company":{"default":true,"type":"boolean"},"company_required":{"default":false,"type":"boolean"},"consent_text":{"default":"I agree that this team may contact me using these details.","type":"string","minLength":1,"maxLength":500},"submit_label":{"default":"Send my details","type":"string","minLength":1,"maxLength":60},"success_message":{"default":"Your details are saved for our team.","type":"string","minLength":1,"maxLength":200},"follow_up_label":{"default":"Book a call","type":"string","minLength":1,"maxLength":60},"follow_up_url":{"default":"","anyOf":[{"type":"string","maxLength":1024},{"type":"string","const":""}]}},"additionalProperties":false}},"additionalProperties":false},"routing":{"type":"object","properties":{"clinician_url":{"type":"string","maxLength":512},"sign_in_url":{"type":"string","maxLength":512},"catalog_url":{"type":"string","maxLength":512},"offer_url":{"type":"string","maxLength":512},"offer_label":{"type":"string","maxLength":80},"destination_origins":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":256}}},"additionalProperties":false}},"required":["enabled","guests_enabled","display_name","allowed_origins","privacy_url","fallback_url","office_hours"],"additionalProperties":false}},"required":["id","settings"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/installations/{installation}":{"patch":{"operationId":"messenger.installations.update","summary":"Update installation settings with the expected version. Keeps the signing key.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"installation","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":1,"maximum":9007199254740991},"settings":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Live widget. The approved setup grant includes production installation and activation."},"guests_enabled":{"type":"boolean"},"display_name":{"type":"string","minLength":1,"maxLength":80,"description":"Company name shown in the Messenger header"},"logo_url":{"description":"Public company logo shown in the header","type":"string","maxLength":1024},"identity":{"description":"Agent name and AI disclosure. Defaults to named support with a neutral first name and last initial.","type":"object","properties":{"mode":{"default":"human","description":"Named support persona (default) or a visible AI assistant label.","type":"string","enum":["human","ai"]},"name_style":{"default":"neutral","type":"string","enum":["neutral","female"]},"custom_name":{"default":"","type":"string","maxLength":80}},"additionalProperties":false},"allowed_origins":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":256},"description":"Exact website origins, https (http://localhost allowed in staging)"},"privacy_url":{"type":"string","maxLength":512},"fallback_url":{"type":"string","maxLength":512},"office_hours":{"type":"string","maxLength":200},"presentation":{"description":"Company chat colors, welcome and chat copy, home/chat links and contact form labels. Plain text only; links use HTTPS. Scoped to this installation.","type":"object","properties":{"colors":{"default":{},"type":"object","properties":{"accent":{"default":"#a95424","type":"string","minLength":7,"maxLength":7,"pattern":"^#[0-9a-f]{6}$"},"customer_bubble":{"default":"#eef1e7","type":"string","minLength":7,"maxLength":7,"pattern":"^#[0-9a-f]{6}$"}},"additionalProperties":false},"welcome_title":{"default":"How can we help?","type":"string","minLength":1,"maxLength":100},"welcome_description":{"default":"","type":"string","maxLength":300},"chat_label":{"default":"Message support","type":"string","minLength":1,"maxLength":60},"header_description":{"default":"Support team","type":"string","minLength":1,"maxLength":100},"thread_title":{"default":"What's on your mind?","type":"string","minLength":1,"maxLength":100},"thread_description":{"default":"Ask a question here. We can help you find the next step.","type":"string","minLength":1,"maxLength":300},"actions":{"default":[{"type":"lead_capture","label":"Request follow-up","show_on_home":false,"show_in_chat":true}],"maxItems":6,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"link"},"label":{"type":"string","minLength":1,"maxLength":60},"url":{"type":"string","maxLength":1024},"show_on_home":{"type":"boolean"},"show_in_chat":{"type":"boolean"}},"required":["type","label","url","show_on_home","show_in_chat"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"lead_capture"},"label":{"type":"string","minLength":1,"maxLength":60},"show_on_home":{"type":"boolean"},"show_in_chat":{"type":"boolean"}},"required":["type","label","show_on_home","show_in_chat"],"additionalProperties":false}]}},"lead_capture":{"default":{},"type":"object","properties":{"title":{"default":"Request follow-up","type":"string","minLength":1,"maxLength":100},"description":{"default":"Leave your details so our team can contact you.","type":"string","minLength":1,"maxLength":300},"name_label":{"default":"Name","type":"string","minLength":1,"maxLength":60},"email_label":{"default":"Email","type":"string","minLength":1,"maxLength":60},"company_label":{"default":"Company","type":"string","minLength":1,"maxLength":60},"phone_label":{"default":"Phone number","type":"string","minLength":1,"maxLength":60},"show_phone":{"default":false,"type":"boolean"},"phone_required":{"default":false,"type":"boolean"},"message_label":{"default":"Message","type":"string","minLength":1,"maxLength":60},"show_message":{"default":true,"type":"boolean"},"show_company":{"default":true,"type":"boolean"},"company_required":{"default":false,"type":"boolean"},"consent_text":{"default":"I agree that this team may contact me using these details.","type":"string","minLength":1,"maxLength":500},"submit_label":{"default":"Send my details","type":"string","minLength":1,"maxLength":60},"success_message":{"default":"Your details are saved for our team.","type":"string","minLength":1,"maxLength":200},"follow_up_label":{"default":"Book a call","type":"string","minLength":1,"maxLength":60},"follow_up_url":{"default":"","anyOf":[{"type":"string","maxLength":1024},{"type":"string","const":""}]}},"additionalProperties":false}},"additionalProperties":false},"routing":{"type":"object","properties":{"clinician_url":{"type":"string","maxLength":512},"sign_in_url":{"type":"string","maxLength":512},"catalog_url":{"type":"string","maxLength":512},"offer_url":{"type":"string","maxLength":512},"offer_label":{"type":"string","maxLength":80},"destination_origins":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":256}}},"additionalProperties":false}},"required":["enabled","guests_enabled","display_name","allowed_origins","privacy_url","fallback_url","office_hours"],"additionalProperties":false}},"required":["expected_version","settings"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/installations/{installation}/rotate-key":{"post":{"operationId":"messenger.installations.rotate_key","summary":"Issue a new signing key. Existing signed sessions end. The key goes to the trusted local helper only.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"secret_write","x-summer-release":"A","x-summer-mcp":"handoff","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"installation","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}},{"name":"Summer-One-Time-Secret","in":"header","required":true,"schema":{"const":"accept"},"description":"Confirms the client writes the returned secret directly to a secret store."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_version":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["expected_version"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/assistant":{"get":{"operationId":"messenger.assistant.read","summary":"Read assistant settings per installation and whether the managed runtime is enabled.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/leads":{"get":{"operationId":"messenger.leads.list","summary":"Read consented website leads for this company and environment. Includes volunteered contact details and original submission references.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"B","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"before","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":120}}],"security":[{"summer":["cases.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/leads/handoff":{"post":{"operationId":"messenger.leads.handoff","summary":"Exchange a short-lived booking handoff code on your server. Returns only this company's submitted contact details. Never use it as account identity.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"B","x-summer-mcp":"none","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"}},"required":["code"],"additionalProperties":false}}}},"security":[{"summer":["cases.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/installations/{installation}/assistant":{"put":{"operationId":"messenger.assistant.update","summary":"Update assistant instructions and escalation permission with the expected revision. Company facts live in shared knowledge. Cannot raise the spending limit.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"installation","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Automatic replies. The approved setup grant includes production activation within the current spending limit."},"instructions":{"type":"string","minLength":1,"maxLength":50000},"lead_capture_enabled":{"description":"Offer an optional consent-based contact form in chat.","type":"boolean"},"escalation_enabled":{"description":"Allow investigation handoffs. Set false for a product and sales chat.","type":"boolean"},"budget_cents":{"type":"integer","minimum":1,"maximum":10000,"description":"Cannot exceed the current limit through the API"}},"required":["enabled","instructions","budget_cents"],"additionalProperties":false}},"required":["revision","settings"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/voice":{"get":{"operationId":"messenger.voice.read","summary":"Read voice chat settings per installation, the voice services and their voices, published help article count and the voice assistant's update status.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/installations/{installation}/voice":{"put":{"operationId":"messenger.voice.update","summary":"Update voice chat settings with the expected revision. Summer updates the voice assistant from these settings and the company's published help articles.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"write","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"installation","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Show the voice button in chat for the chosen audience."},"audience":{"type":"string","enum":["accounts","signed_in","everyone"],"description":"accounts: only allowed_subjects; signed_in: any verified account; everyone: visitors too."},"allowed_subjects":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"description":"Verified account subjects your site sends at sign-in. Used when audience is accounts."},"provider":{"description":"Voice service. openai (OpenAI Realtime) is the default. Omit to keep the saved choice.","type":"string","enum":["openai","elevenlabs"]},"voice_id":{"type":"string","pattern":"^[A-Za-z0-9]{8,40}$","description":"ElevenLabs voice: one of the voices listed by messenger.voice.read."},"openai_voice":{"description":"OpenAI voice: one of the openai_voices listed by messenger.voice.read. Omit to keep the saved choice.","type":"string","enum":["alloy","ash","ballad","coral","echo","sage","shimmer","verse","marin","cedar"]},"instructions":{"type":"string","maxLength":20000,"description":"Optional company instructions added to the standard voice instructions."},"vocabulary":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":60},"description":"Words speech recognition should expect, such as product names."}},"required":["enabled","audience","allowed_subjects","voice_id","instructions","vocabulary"],"additionalProperties":false}},"required":["revision","settings"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/team":{"get":{"operationId":"company.team.read","summary":"List company members and pending invitations. Role changes and invitations stay in Summer.","tags":["company"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"D","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/messenger/conversations/{conversation}/assistant":{"post":{"operationId":"messenger.conversations.assistant","summary":"Pause the assistant in one conversation so a person can take over, or ask it to resume. Pausing stops automatic replies immediately.","tags":["messenger"],"x-summer-ownership":"environment","x-summer-effect":"request","x-summer-release":"C","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"conversation","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"paused":{"type":"boolean"}},"required":["paused"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/verification":{"post":{"operationId":"verification.run","summary":"Run supported harmless checks. Unsupported checks are reported as unsupported, never as passed.","tags":["verification"],"x-summer-ownership":"environment","x-summer-effect":"request","x-summer-release":"A","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targets":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["credentials","providers","slack","messenger"]}}},"required":["targets"],"additionalProperties":false}}}},"security":[{"summer":["setup"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/cases":{"get":{"operationId":"cases.list","summary":"List company-owned cases or conversations, newest first, with coverage and a cursor. Text search is not available through the API yet.","tags":["cases"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"B","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"cursor","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","minimum":1,"maximum":200}},{"name":"status","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["open","resolved","all"]}}],"security":[{"summer":["cases.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/cases/{case}":{"get":{"operationId":"cases.get","summary":"Read one case or conversation with its original messages and related records.","tags":["cases"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"B","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"case","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"after","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","minimum":0,"maximum":9007199254740991}}],"security":[{"summer":["cases.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/cases/{case}/attachments/{attachment}":{"get":{"operationId":"cases.attachment","summary":"Get a short-lived download for an attachment that belongs to this case.","tags":["cases"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"B","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"case","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"attachment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"security":[{"summer":["cases.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/cases/{case}/investigations":{"get":{"operationId":"investigations.list","summary":"Read investigation runs, saved plans, approval state and execution receipts for a case.","tags":["investigations"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"B","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"case","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"security":[{"summer":["cases.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"investigations.request","summary":"Ask Summer to investigate the case, or revise a saved plan with feedback. Completion is not approval.","tags":["investigations"],"x-summer-ownership":"environment","x-summer-effect":"request","x-summer-release":"B","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"case","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"investigate"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"revise"},"plan_request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"feedback":{"type":"string","minLength":1,"maxLength":2000}},"required":["kind","plan_request_id","feedback"],"additionalProperties":false}]}}}},"security":[{"summer":["investigations.request"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/cases/{case}/actions/prepare":{"post":{"operationId":"actions.prepare","summary":"Prepare the exact work in the current saved plan for human approval in Summer. Does not approve or execute.","tags":["actions"],"x-summer-ownership":"environment","x-summer-effect":"request","x-summer-release":"C","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"case","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan_request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["plan_request_id"],"additionalProperties":false}}}},"security":[{"summer":["actions.prepare"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/events":{"get":{"operationId":"events.list","summary":"Read configuration and activity events after a cursor. Resume from next_cursor.","tags":["events"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"D","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"after","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^\\d{1,18}$"}},{"name":"limit","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","minimum":1,"maximum":200}}],"security":[{"summer":["setup"]},{"summer":["events.read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/service-accounts":{"get":{"operationId":"service_accounts.list","summary":"List the company's service accounts.","tags":["service_accounts"],"x-summer-ownership":"company","x-summer-effect":"read","x-summer-release":"D","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}}],"security":[{"summer":["automation.manage"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/service-accounts/{account}":{"put":{"operationId":"service_accounts.save","summary":"Create, update, rotate or disable a service account. A new secret goes to the trusted local helper only.","tags":["service_accounts"],"x-summer-ownership":"company","x-summer-effect":"secret_write","x-summer-release":"D","x-summer-mcp":"handoff","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"account","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}},{"name":"Summer-One-Time-Secret","in":"header","required":true,"schema":{"const":"accept"},"description":"Confirms the client writes the returned secret directly to a secret store."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"environments":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},"scopes":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["events.read","capabilities.read"]}},"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"},"rotate_secret":{"default":false,"type":"boolean"},"disable":{"default":false,"type":"boolean"}},"required":["name","environments","scopes","expected_version"],"additionalProperties":false}}}},"security":[{"summer":["automation.manage"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/webhooks":{"get":{"operationId":"webhooks.list","summary":"List webhook endpoints and delivery state.","tags":["webhooks"],"x-summer-ownership":"environment","x-summer-effect":"read","x-summer-release":"D","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}}],"security":[{"summer":["automation.manage"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/webhooks/{webhook}":{"put":{"operationId":"webhooks.save","summary":"Create, update, rotate or disable a signed webhook endpoint. A new signing secret goes to the trusted local helper only.","tags":["webhooks"],"x-summer-ownership":"environment","x-summer-effect":"secret_write","x-summer-release":"D","x-summer-mcp":"handoff","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"webhook","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}},{"name":"Summer-One-Time-Secret","in":"header","required":true,"schema":{"const":"accept"},"description":"Confirms the client writes the returned secret directly to a secret store."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","maxLength":512,"format":"uri"},"event_types":{"minItems":1,"maxItems":32,"type":"array","items":{"type":"string","pattern":"^(\\*|[a-z][a-z0-9_.]{2,80})$"}},"expected_version":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Current version you expect; 0 when the resource does not exist yet"},"rotate_secret":{"default":false,"type":"boolean"},"disable":{"default":false,"type":"boolean"}},"required":["url","event_types","expected_version"],"additionalProperties":false}}}},"security":[{"summer":["automation.manage"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/companies/{company}/environments/{environment}/webhooks/{webhook}/replay":{"post":{"operationId":"webhooks.replay","summary":"Queue past events after a cursor for delivery again to one endpoint. Receivers deduplicate by event ID.","tags":["webhooks"],"x-summer-ownership":"environment","x-summer-effect":"request","x-summer-release":"D","x-summer-mcp":"full","parameters":[{"name":"company","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Summer company ID"}},{"name":"environment","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["staging","production"],"description":"Environment that owns the resource"}},{"name":"webhook","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"after":{"type":"string","pattern":"^\\d{1,18}$"},"limit":{"default":200,"type":"integer","minimum":1,"maximum":1000}},"required":["after"],"additionalProperties":false}}}},"security":[{"summer":["automation.manage"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"summer":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://gosummer.ai/oauth/authorize","tokenUrl":"https://gosummer.ai/api/oauth/token","refreshUrl":"https://gosummer.ai/api/oauth/token","scopes":{"setup":"Inspect and update capability readiness, configure integrations, install and enable Messenger in the selected environments, save selected credentials without reading them back, upload company knowledge and run supported checks.","cases.read":"Read company-owned cases, conversations, related records, attachments, runs, plans and receipts.","investigations.request":"Ask Summer to investigate a case or revise a plan. Results still need human review.","actions.prepare":"Prepare the exact work in a saved plan so a person can approve it in Summer. Never approves or executes anything.","credentials.replace":"Replace or remove a provider credential that is already saved and active.","messaging.activate":"Enable a production Messenger installation or automatic production assistant replies.","guides.publish":"Publish or unpublish exact customer guide revisions and configure their public custom domain. Draft authoring and private uploads use setup.","automation.manage":"Create, rotate and disable company service accounts and signed webhooks."}},"clientCredentials":{"tokenUrl":"https://gosummer.ai/api/oauth/token","scopes":{"events.read":"Read the company's configuration and activity events.","capabilities.read":"Read company capabilities and setup status."}}}}},"responses":{"Error":{"description":"Error","content":{"application/json":{"schema":{"type":"object","required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"enum":["invalid_request","invalid_token","insufficient_scope","approval_pending","access_blocked","company_not_granted","environment_not_granted","not_a_member","admin_required","human_required","not_found","method_not_allowed","version_conflict","idempotency_conflict","idempotency_in_progress","outcome_uncertain","payload_too_large","rate_limited","unsupported","unavailable","developer_platform_disabled"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}}},"request_id":{"type":"string","format":"uuid"}}}}}}}}}