{"openapi":"3.1.2","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"TellTell Account API","version":"1.0.0","description":"Admin-delegated account operations. Routine mutations execute directly. Bulk edits require connection-level opt-in. Lists default to 50 records, maximum 100. Account and actor derive from the OAuth grant."},"servers":[{"url":"https://telltell-web-789927640952.us-east1.run.app/v1"}],"paths":{"/context":{"get":{"operationId":"context.get","description":"Read the connected TellTell account, current scopes, and bulk-edit policy.","tags":["context"],"security":[{"accountOAuth":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/context.get.Output"},"example":{"accountId":"10000000-0000-4000-8000-000000000001","userId":"10000000-0000-4000-8000-000000000001","connectionId":"10000000-0000-4000-8000-000000000001","scopes":[],"bulkEditsEnabled":false}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_context_get"}}},"/people":{"get":{"operationId":"people.list","description":"Search and list people in bounded pages. Read the individual record before editing to obtain its current version.","tags":["people"],"security":[{"accountOAuth":["people:read"]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4096}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"example":50},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.list.Output"},"example":{"items":[],"nextCursor":"Example"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_people_list"}},"post":{"operationId":"people.create","description":"Create a person in the People directory with email addresses and optional custom-field values.","tags":["people"],"security":[{"accountOAuth":["people:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.create.Input"},"example":{"name":"Example","emails":["alex@example.test"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.create.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_people_create"}}},"/teams":{"get":{"operationId":"teams.list","description":"Search and list teams in bounded pages. Read the individual record before editing to obtain its current version.","tags":["teams"],"security":[{"accountOAuth":["groups:read"]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4096}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"example":50},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/teams.list.Output"},"example":{"items":[],"nextCursor":"Example"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_teams_list"}},"post":{"operationId":"teams.create","description":"Create a team within the account's existing plan entitlement.","tags":["teams"],"security":[{"accountOAuth":["groups:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/teams.create.Input"},"example":{"name":"Example","mailKey":"Example"}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/teams.create.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_teams_create"}}},"/groups":{"get":{"operationId":"groups.list","description":"Search and list groups in bounded pages. Read the individual record before editing to obtain its current version.","tags":["groups"],"security":[{"accountOAuth":["groups:read"]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4096}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"example":50},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.list.Output"},"example":{"items":[],"nextCursor":"Example"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_groups_list"}},"post":{"operationId":"groups.create","description":"Create a group in an existing team using its managed TellTell address.","tags":["groups"],"security":[{"accountOAuth":["groups:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.create.Input"},"example":{"teamId":"10000000-0000-4000-8000-000000000001","name":"Example","groupKey":"Example","description":""}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.create.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_groups_create"}}},"/fields":{"get":{"operationId":"fields.list","description":"Search and list fields in bounded pages. Read the individual record before editing to obtain its current version.","tags":["fields"],"security":[{"accountOAuth":["fields:read"]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4096}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"example":50},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.list.Output"},"example":{"items":[],"nextCursor":"Example"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_list"}},"post":{"operationId":"fields.create","description":"Create a custom-field definition with explicit type and configuration.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.create.Input"},"example":{"key":"Example","name":"Example","type":"text","required":false,"showOnAdd":false,"allowBulkEdit":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.create.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_create"}}},"/people/{id}":{"get":{"operationId":"people.get","description":"Read a person's emails, group assignments, custom-field values, and current version.","tags":["people"],"security":[{"accountOAuth":["people:read"]}],"parameters":[{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.get.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","version":"1","name":"Example","emails":[],"groupIds":[],"customFields":{}}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_people_get"}},"patch":{"operationId":"people.update","description":"Update a person's name, ordered email addresses (primary first), and optional field values. New email addresses may receive configured group welcome emails.","tags":["people"],"security":[{"accountOAuth":["people:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.update.Input"},"example":{"name":"Example","emails":["alex@example.test"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":true,"backgroundJob":false,"mcpTool":"telltell_people_update"}},"delete":{"operationId":"people.delete","description":"Remove a person and their group memberships under TellTell's existing retention rules. Ask for approval in the AI conversation before calling.","tags":["people"],"security":[{"accountOAuth":["people:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.delete.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_people_delete"}}},"/people/merges":{"post":{"operationId":"people.merge","description":"Merge people into the selected primary person. Requires bulk access and current versions of every selected person. Present the proposed merge and ask for approval in the conversation first.","tags":["people"],"security":[{"accountOAuth":["people:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.merge.Input"},"example":{"name":"Example","primaryPersonId":"10000000-0000-4000-8000-000000000001","personIds":["10000000-0000-4000-8000-000000000001","10000000-0000-4000-8000-000000000001"],"expectedVersions":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.merge.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":true,"destructive":true,"emailSideEffects":true,"backgroundJob":false,"mcpTool":"telltell_people_merge"}}},"/people/{id}/fields":{"patch":{"operationId":"people.fields.update","description":"Set the selected custom-field or tag values on one person, preserving other fields. Use append or replace explicitly for multi-choice fields.","tags":["people"],"security":[{"accountOAuth":["people:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.fields.update.Input"},"example":{"updates":[{"definitionId":"10000000-0000-4000-8000-000000000001"}],"mode":"append"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/people.fields.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_people_fields_update"}}},"/people/{personId}/memberships/{groupId}":{"put":{"operationId":"memberships.set","description":"Add or remove one person's membership in one group. Adding membership honors configured welcome emails. Use the person's current version.","tags":["memberships"],"security":[{"accountOAuth":["groups:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"personId","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"},{"name":"groupId","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/memberships.set.Input"},"example":{"active":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/memberships.set.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":true,"backgroundJob":false,"mcpTool":"telltell_memberships_set"}}},"/teams/{id}":{"get":{"operationId":"teams.get","description":"Read a team's ordinary settings and current version.","tags":["teams"],"security":[{"accountOAuth":["groups:read"]}],"parameters":[{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/teams.get.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","version":"1","name":"Example","mailKey":"Example","memberColumnIds":[]}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_teams_get"}},"patch":{"operationId":"teams.update","description":"Update a team name, mail key, and optional directory columns. Changing the mail key changes its managed group addresses.","tags":["teams"],"security":[{"accountOAuth":["groups:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/teams.update.Input"},"example":{"name":"Example","mailKey":"Example"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/teams.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_teams_update"}},"delete":{"operationId":"teams.delete","description":"Remove a team and its groups under existing TellTell rules. Present the impact and ask for approval in the conversation first.","tags":["teams"],"security":[{"accountOAuth":["groups:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/teams.delete.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_teams_delete"}}},"/groups/{id}":{"get":{"operationId":"groups.get","description":"Read a group's address, sending/reply settings, notices, and current version.","tags":["groups"],"security":[{"accountOAuth":["groups:read"]}],"parameters":[{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.get.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","version":"1","teamId":"10000000-0000-4000-8000-000000000001","name":"Example","groupKey":"Example","address":"Example","description":"Example","color":"#647187","senderPolicy":"members","replyMode":"disabled","replyToAddress":"Example","allowedSenders":[],"allowedPersonIds":[],"welcomeEnabled":false,"welcomeHtml":"Example","customFooterHtml":"Example"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_groups_get"}},"patch":{"operationId":"groups.update","description":"Update a group's name, managed address key, description, and color.","tags":["groups"],"security":[{"accountOAuth":["groups:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.update.Input"},"example":{"name":"Example","groupKey":"Example","description":"Example","color":"#647187"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_groups_update"}},"delete":{"operationId":"groups.delete","description":"Remove a group and its memberships. Present the impact and ask for approval in the conversation first.","tags":["groups"],"security":[{"accountOAuth":["groups:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.delete.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_groups_delete"}}},"/groups/{id}/permissions":{"patch":{"operationId":"groups.permissions.update","description":"Change a group's permitted senders and reply behavior. Explain these mail-delivery changes and ask for approval in the conversation first.","tags":["groups"],"security":[{"accountOAuth":["groups:write","settings:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.permissions.update.Input"},"example":{"senderPolicy":"members","replyMode":"disabled","allowedSenders":[],"allowedPersonIds":[]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.permissions.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_groups_permissions_update"}}},"/groups/{id}/notices":{"patch":{"operationId":"groups.notices.update","description":"Update sanitized welcome-message and message-footer content. These settings affect future email; explain the changes and ask for approval in the conversation first.","tags":["groups"],"security":[{"accountOAuth":["groups:write","settings:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.notices.update.Input"},"example":{"welcomeHtml":"Example","customFooterHtml":"Example"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.notices.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_groups_notices_update"}}},"/fields/{id}":{"get":{"operationId":"fields.get","description":"Read a custom-field or Tags definition, its choices, and current version.","tags":["fields"],"security":[{"accountOAuth":["fields:read"]}],"parameters":[{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.get.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","version":"1","key":"Example","name":"Example","type":"text","required":false,"showOnAdd":false,"allowBulkEdit":false,"position":-9007199254740991,"options":[]}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_get"}},"patch":{"operationId":"fields.update","description":"Update or archive a custom-field definition, preserving TellTell's protected Tags rules.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.update.Input"},"example":{"name":"Example","archived":false,"position":0,"required":false,"showOnAdd":false,"allowBulkEdit":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_update"}}},"/fields/order":{"put":{"operationId":"fields.reorder","description":"Reorder custom-field definitions. Supply all definition IDs and their current versions.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.reorder.Input"},"example":{"orderedDefinitionIds":["10000000-0000-4000-8000-000000000001"],"expectedVersions":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.reorder.Output"},"example":{"ids":[]}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_reorder"}}},"/fields/{definitionId}/options":{"post":{"operationId":"fields.options.create","description":"Add a choice or tag to a field using the field's current version.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"definitionId","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.create.Input"},"example":{"label":"Example"}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.create.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0,"optionId":"10000000-0000-4000-8000-000000000001"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_options_create"}}},"/fields/{definitionId}/options/{id}":{"patch":{"operationId":"fields.options.update","description":"Update a choice or tag's label, color, and position using the parent field's current version.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"definitionId","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.update.Input"},"example":{"label":"Example","position":0}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_options_update"}},"delete":{"operationId":"fields.options.delete","description":"Delete a choice or tag and its assignments. Requires bulk access; present the impact and ask for approval in the conversation first.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"definitionId","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.delete.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":true,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_options_delete"}}},"/fields/{definitionId}/option-replacements":{"post":{"operationId":"fields.options.replace","description":"Replace a choice/tag with another in the same field, updating assignments. Requires bulk access and conversational approval.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"definitionId","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.replace.Input"},"example":{"sourceOptionId":"10000000-0000-4000-8000-000000000001","replacementOptionId":"10000000-0000-4000-8000-000000000001"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.replace.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":true,"destructive":true,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_options_replace"}}},"/fields/{definitionId}/options/order":{"put":{"operationId":"fields.options.reorder","description":"Reorder choices within a field using its current version.","tags":["fields"],"security":[{"accountOAuth":["fields:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""},{"name":"definitionId","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.reorder.Input"},"example":{"orderedOptionIds":[]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fields.options.reorder.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_fields_options_reorder"}}},"/settings":{"get":{"operationId":"settings.get","description":"Read ordinary account settings and their current version.","tags":["settings"],"security":[{"accountOAuth":["settings:read"]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/settings.get.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","version":"1","name":"Example","automaticAvatarsEnabled":false}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_settings_get"}},"patch":{"operationId":"settings.update","description":"Update the account name and automatic-photo preference. Connection permissions, billing, login, and lifecycle settings are excluded.","tags":["settings"],"security":[{"accountOAuth":["settings:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[1-9][0-9]{0,18}\"$"},"example":"\"1\""}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/settings.update.Input"},"example":{"name":"Example","automaticAvatarsEnabled":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/settings.update.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_settings_update"}}},"/batch-previews":{"post":{"operationId":"batches.preview","description":"Store an exact preview of bulk field edits, group assignments, or a CSV import without changing directory records. Field batches additionally require people:write and fields:read; membership batches require groups:read and groups:write; imports require all four. Read all preview pages before requesting conversational approval. API scripts may preview and apply unattended.","tags":["batches"],"security":[{"accountOAuth":["people:read"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/batches.preview.Input"},"example":{"batch":{"kind":"fields","personIds":["10000000-0000-4000-8000-000000000001"],"updates":[{"definitionId":"10000000-0000-4000-8000-000000000001"}],"mode":"append"}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/batches.preview.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","digest":"Example","expiresAt":"Example","totalWork":1,"items":[],"nextCursor":"Example","warnings":[]}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":true,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_batches_preview"}}},"/batch-previews/{id}":{"get":{"operationId":"batches.get","description":"Read a page of a stored bulk preview, including proposed changes and conflicts. Requires the preview's original category scopes and continued bulk access.","tags":["batches"],"security":[{"accountOAuth":["people:read"]}],"parameters":[{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":20}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/batches.get.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","digest":"Example","expiresAt":"Example","totalWork":1,"items":[],"nextCursor":"Example","warnings":[]}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_batches_get"}}},"/batch-previews/{id}/jobs":{"post":{"operationId":"batches.apply","description":"Apply an exact stored preview after rechecking permissions and versions. Requires jobs:write, the preview's original category scopes, and bulk access. AI clients should ask for approval first; the API requires no approval flag. Returns a durable job receipt; configured welcome emails may be sent.","tags":["batches"],"security":[{"accountOAuth":["jobs:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/batches.apply.Input"},"example":{"digest":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}}},"responses":{"202":{"description":"Job queued. Poll Location for results; cancellation preserves completed work.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/batches.apply.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","kind":"Example","queuePosition":-9007199254740991,"state":"Example","title":"Example","totalWork":-9007199254740991,"unitLabel":"Example"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"Location":{"schema":{"type":"string","format":"uri"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":true,"destructive":true,"emailSideEffects":true,"backgroundJob":true,"mcpTool":"telltell_batches_apply"}}},"/jobs":{"get":{"operationId":"jobs.list","description":"List jobs created by this connection with bounded progress summaries.","tags":["jobs"],"security":[{"accountOAuth":["jobs:read"]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4096}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"example":50}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/jobs.list.Output"},"example":{"items":[],"lastViewedAt":"Example","nextCursor":"Example"}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_jobs_list"}}},"/jobs/{id}":{"get":{"operationId":"jobs.get","description":"Read progress and failures for a job created by this connection.","tags":["jobs"],"security":[{"accountOAuth":["jobs:read"]}],"parameters":[{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/jobs.get.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","kind":"Example","queuePosition":-9007199254740991,"state":"Example","title":"Example","totalWork":-9007199254740991,"unitLabel":"Example","cancelRequestedAt":"Example","completedAt":"Example","createdAt":"Example","createdByCurrentUser":false,"elapsedMs":1,"failedWork":1,"processedWork":1,"skippedWork":1,"startedAt":"Example","succeededWork":1,"estimatedRemainingMs":1,"failureExamples":[],"importRecordId":"Example","queueWaitMs":1}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_jobs_get"}}},"/jobs/{id}/cancellation":{"post":{"operationId":"jobs.cancel","description":"Cancel remaining work for a job created by this connection. The current atomic item may finish; completed changes and queued mail are retained.","tags":["jobs"],"security":[{"accountOAuth":["jobs:write"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","description":"A unique 16–200 character key. Reuse it only with the same operation and payload when retrying."},{"name":"id","in":"path","required":true,"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)$"},"example":"10000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/jobs.cancel.Output"},"example":{"id":"10000000-0000-4000-8000-000000000001","emailJobsQueued":0}}},"headers":{"X-Correlation-ID":{"schema":{"type":"string","format":"uuid"}},"ETag":{"schema":{"type":"string"},"description":"Strong resource version; use as If-Match on updates."}}},"400":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"412":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"428":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"RFC 9457 problem details with stable TellTell code and correlation ID.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-telltell":{"bulkAccessRequired":false,"destructive":false,"emailSideEffects":false,"backgroundJob":false,"mcpTool":"telltell_jobs_cancel"}}}},"components":{"schemas":{"context.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"required":[]},"context.get.Output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"accountId":{"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)$"},"userId":{"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)$"},"connectionId":{"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)$"},"scopes":{"type":"array","items":{"type":"string"}},"bulkEditsEnabled":{"type":"boolean"}},"required":["accountId","userId","connectionId","scopes","bulkEditsEnabled"],"additionalProperties":false},"people.list.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"required":[]},"people.list.Output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"maxItems":100,"type":"array","items":{"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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"name":{"type":"string","minLength":1,"maxLength":200},"primaryEmail":{"type":"string"},"teamId":{"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":["id","version","name"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"],"additionalProperties":false},"teams.list.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"required":[]},"teams.list.Output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"maxItems":100,"type":"array","items":{"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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"name":{"type":"string","minLength":1,"maxLength":200},"primaryEmail":{"type":"string"},"teamId":{"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":["id","version","name"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"],"additionalProperties":false},"groups.list.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"required":[]},"groups.list.Output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"maxItems":100,"type":"array","items":{"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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"name":{"type":"string","minLength":1,"maxLength":200},"primaryEmail":{"type":"string"},"teamId":{"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":["id","version","name"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"],"additionalProperties":false},"fields.list.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"required":[]},"fields.list.Output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"maxItems":100,"type":"array","items":{"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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"name":{"type":"string","minLength":1,"maxLength":200},"primaryEmail":{"type":"string"},"teamId":{"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":["id","version","name"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"],"additionalProperties":false},"people.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"people.get.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"name":{"type":"string","minLength":1,"maxLength":200},"emails":{"type":"array","items":{"type":"string","maxLength":320,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"groupIds":{"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)$"}},"customFields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"optionIds":{"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)$"}},"relationshipPersonIds":{"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)$"}},"reverseRelationshipPersonIds":{"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)$"}},"scalarValue":{"$ref":"#/components/schemas/people.get.Output/$defs/__schema0"}},"required":["optionIds","relationshipPersonIds","reverseRelationshipPersonIds"],"additionalProperties":false}}},"required":["id","version","name","emails","groupIds","customFields"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/people.get.Output/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/people.get.Output/$defs/__schema0"}}]}}},"people.create.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"emails":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":320,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"customFields":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"definitionId":{"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)$"},"value":{"$ref":"#/components/schemas/people.create.Input/$defs/__schema0"},"reverseValue":{"$ref":"#/components/schemas/people.create.Input/$defs/__schema1"}},"required":["definitionId"],"additionalProperties":false}}},"required":["name","emails"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/people.create.Input/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/people.create.Input/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/people.create.Input/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/people.create.Input/$defs/__schema1"}}]}}},"people.create.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"people.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"emails":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":320,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"customFields":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"definitionId":{"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)$"},"value":{"$ref":"#/components/schemas/people.update.Input/$defs/__schema0"},"reverseValue":{"$ref":"#/components/schemas/people.update.Input/$defs/__schema1"}},"required":["definitionId"],"additionalProperties":false}}},"required":["name","emails"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/people.update.Input/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/people.update.Input/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/people.update.Input/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/people.update.Input/$defs/__schema1"}}]}}},"people.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"people.delete.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"people.delete.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"people.merge.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"primaryPersonId":{"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)$"},"personIds":{"minItems":2,"maxItems":20,"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)$"}},"expectedVersions":{"type":"object","propertyNames":{"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)$"},"additionalProperties":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"}}},"required":["name","primaryPersonId","personIds","expectedVersions"],"additionalProperties":false},"people.merge.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"people.fields.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updates":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"definitionId":{"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)$"},"value":{"$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema0"},"reverseValue":{"$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema1"}},"required":["definitionId"],"additionalProperties":false}},"mode":{"type":"string","enum":["append","replace"]}},"required":["updates","mode"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema1"}}]}}},"people.fields.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"memberships.set.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"active":{"type":"boolean"}},"required":["active"],"additionalProperties":false},"memberships.set.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"teams.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"teams.get.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"name":{"type":"string","minLength":1,"maxLength":200},"mailKey":{"type":"string"},"memberColumnIds":{"type":"array","items":{"type":"string"}}},"required":["id","version","name","mailKey","memberColumnIds"],"additionalProperties":false},"teams.create.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"mailKey":{"type":"string","minLength":1,"maxLength":63}},"required":["name","mailKey"],"additionalProperties":false},"teams.create.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"teams.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"mailKey":{"type":"string","minLength":1,"maxLength":63},"memberColumnIds":{"maxItems":100,"type":"array","items":{"type":"string"}}},"required":["name","mailKey"],"additionalProperties":false},"teams.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"teams.delete.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"teams.delete.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"groups.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"groups.get.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"teamId":{"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":{"type":"string","minLength":1,"maxLength":200},"groupKey":{"type":"string"},"address":{"type":"string"},"description":{"type":"string"},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"senderPolicy":{"type":"string","enum":["members","restricted"]},"replyMode":{"type":"string","enum":["disabled","group","specific"]},"replyToAddress":{"type":["string","null"]},"allowedSenders":{"type":"array","items":{"type":"string"}},"allowedPersonIds":{"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)$"}},"welcomeEnabled":{"type":"boolean"},"welcomeHtml":{"type":"string"},"customFooterHtml":{"type":"string"}},"required":["id","version","teamId","name","groupKey","address","description","color","senderPolicy","replyMode","replyToAddress","allowedSenders","allowedPersonIds","welcomeEnabled","welcomeHtml","customFooterHtml"],"additionalProperties":false},"groups.create.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"teamId":{"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":{"type":"string","minLength":1,"maxLength":200},"groupKey":{"type":"string","minLength":1,"maxLength":63},"description":{"default":"","type":"string","maxLength":2000},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]}},"required":["teamId","name","groupKey"],"additionalProperties":false},"groups.create.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"groups.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"groupKey":{"type":"string","minLength":1,"maxLength":63},"description":{"type":"string","maxLength":2000},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]}},"required":["name","groupKey","description","color"],"additionalProperties":false},"groups.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"groups.delete.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"groups.delete.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"groups.permissions.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"senderPolicy":{"type":"string","enum":["members","restricted"]},"replyMode":{"type":"string","enum":["disabled","group","specific"]},"replyToAddress":{"type":"string","maxLength":320,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"allowedSenders":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":320,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"allowedPersonIds":{"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)$"}}},"required":["senderPolicy","replyMode","allowedSenders","allowedPersonIds"],"additionalProperties":false},"groups.permissions.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"groups.notices.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"welcomeHtml":{"type":"string","maxLength":50000},"customFooterHtml":{"type":"string","maxLength":50000}},"required":["welcomeHtml","customFooterHtml"],"additionalProperties":false},"groups.notices.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"fields.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"fields.get.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"key":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["text","integer","boolean","single_choice","multi_choice","date","phone","postal_address","messaging_handle","person_relationship"]},"required":{"type":"boolean"},"showOnAdd":{"type":"boolean"},"allowBulkEdit":{"type":"boolean"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"options":{"type":"array","items":{"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)$"},"label":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"color":{"type":"string"}},"required":["id","label","position"],"additionalProperties":false}},"helpText":{"type":"string"},"archivedAt":{"type":"string"},"protectedKind":{"type":"string","const":"tags"},"datePrecision":{"type":"string","enum":["full_date","year"]},"messagingChannel":{"type":"string"},"messagingChannelLabel":{"type":"string"},"relationship":{"type":"object","properties":{"forwardLabel":{"type":"string"},"reverseLabel":{"type":"string"}},"required":["forwardLabel","reverseLabel"],"additionalProperties":false}},"required":["id","version","key","name","type","required","showOnAdd","allowBulkEdit","position","options"],"additionalProperties":false},"fields.create.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":63},"name":{"type":"string","minLength":1,"maxLength":120},"type":{"type":"string","enum":["text","integer","boolean","single_choice","multi_choice","date","phone","postal_address","messaging_handle","person_relationship"]},"required":{"default":false,"type":"boolean"},"showOnAdd":{"default":false,"type":"boolean"},"allowBulkEdit":{"default":false,"type":"boolean"},"helpText":{"type":"string","maxLength":500},"datePrecision":{"type":"string","enum":["full_date","year"]},"relationship":{"type":"object","properties":{"forwardLabel":{"type":"string","minLength":1,"maxLength":120},"reverseLabel":{"type":"string","minLength":1,"maxLength":120}},"required":["forwardLabel","reverseLabel"],"additionalProperties":false},"messagingChannel":{"type":"string","enum":["sms","whatsapp","signal","telegram","discord","slack","google_chat","microsoft_teams","facebook_messenger","instagram","x","other"]},"messagingChannelLabel":{"type":"string","maxLength":80}},"required":["key","name","type"],"additionalProperties":false},"fields.create.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"fields.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"archived":{"type":"boolean"},"position":{"type":"integer","minimum":0,"maximum":9007199254740991},"required":{"type":"boolean"},"showOnAdd":{"type":"boolean"},"allowBulkEdit":{"type":"boolean"},"helpText":{"type":"string","maxLength":500},"relationship":{"type":"object","properties":{"forwardLabel":{"type":"string","minLength":1,"maxLength":120},"reverseLabel":{"type":"string","minLength":1,"maxLength":120}},"required":["forwardLabel","reverseLabel"],"additionalProperties":false}},"required":["name","archived","position","required","showOnAdd","allowBulkEdit"],"additionalProperties":false},"fields.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"fields.reorder.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orderedDefinitionIds":{"minItems":1,"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)$"}},"expectedVersions":{"type":"object","propertyNames":{"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)$"},"additionalProperties":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"}}},"required":["orderedDefinitionIds","expectedVersions"],"additionalProperties":false},"fields.reorder.Output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ids":{"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)$"}}},"required":["ids"],"additionalProperties":false},"fields.options.create.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":120}},"required":["label"],"additionalProperties":false},"fields.options.create.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"optionId":{"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":["id","emailJobsQueued","optionId"],"additionalProperties":false},"fields.options.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":120},"position":{"type":"integer","minimum":0,"maximum":9007199254740991},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"required":["label","position"],"additionalProperties":false},"fields.options.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"fields.options.delete.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"fields.options.delete.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"fields.options.replace.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sourceOptionId":{"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)$"},"replacementOptionId":{"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":["sourceOptionId","replacementOptionId"],"additionalProperties":false},"fields.options.replace.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"fields.options.reorder.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orderedOptionIds":{"maxItems":500,"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)$"}}},"required":["orderedOptionIds"],"additionalProperties":false},"fields.options.reorder.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"settings.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"required":[]},"settings.get.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"name":{"type":"string","minLength":1,"maxLength":200},"automaticAvatarsEnabled":{"type":"boolean"}},"required":["id","version","name","automaticAvatarsEnabled"],"additionalProperties":false},"settings.update.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"automaticAvatarsEnabled":{"type":"boolean"}},"required":["name","automaticAvatarsEnabled"],"additionalProperties":false},"settings.update.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"batches.preview.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batch":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"fields"},"personIds":{"minItems":1,"maxItems":500,"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)$"}},"updates":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"definitionId":{"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)$"},"value":{"$ref":"#/components/schemas/batches.preview.Input/$defs/__schema0"},"reverseValue":{"$ref":"#/components/schemas/batches.preview.Input/$defs/__schema1"}},"required":["definitionId"],"additionalProperties":false}},"mode":{"type":"string","enum":["append","replace"]}},"required":["kind","personIds","updates","mode"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"memberships"},"personIds":{"minItems":1,"maxItems":500,"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)$"}},"groupIds":{"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)$"}},"mode":{"type":"string","enum":["add","remove","replace"]}},"required":["kind","personIds","groupIds","mode"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"import"},"csv":{"type":"string","minLength":1,"maxLength":5000000},"sourceName":{"type":"string","minLength":1,"maxLength":255},"headerRow":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"mapping":{"type":"object","properties":{"nameColumn":{"type":"string","minLength":1},"emailColumns":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string"}},"primaryEmailColumn":{"type":"string"},"groupIds":{"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)$"}},"fields":{"default":[],"maxItems":100,"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"definitionId":{"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":["column","definitionId"],"additionalProperties":false}}},"required":["nameColumn","emailColumns","groupIds"],"additionalProperties":false},"assignmentMode":{"type":"string","enum":["append","replace"]},"allowPartial":{"default":false,"type":"boolean"},"recentlyRemovedResolution":{"default":"skip","type":"string","enum":["restore","skip"]}},"required":["kind","csv","sourceName","mapping","assignmentMode"],"additionalProperties":false}]}},"required":["batch"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/batches.preview.Input/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/batches.preview.Input/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/batches.preview.Input/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/batches.preview.Input/$defs/__schema1"}}]}}},"batches.preview.Output":{"$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)$"},"digest":{"type":"string"},"expiresAt":{"type":"string"},"totalWork":{"type":"number"},"items":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"ordinal":{"type":"number"},"personId":{"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":{"type":"string"},"expectedVersion":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"operation":{"type":"string"},"changes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/batches.preview.Output/$defs/__schema0"}},"conflicts":{"type":"array","items":{"type":"string"}}},"required":["ordinal","name","operation","changes","conflicts"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["id","digest","expiresAt","totalWork","items","nextCursor","warnings"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/batches.preview.Output/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/batches.preview.Output/$defs/__schema0"}}]}}},"batches.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"batches.get.Output":{"$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)$"},"digest":{"type":"string"},"expiresAt":{"type":"string"},"totalWork":{"type":"number"},"items":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"ordinal":{"type":"number"},"personId":{"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":{"type":"string"},"expectedVersion":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"operation":{"type":"string"},"changes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/batches.get.Output/$defs/__schema0"}},"conflicts":{"type":"array","items":{"type":"string"}}},"required":["ordinal","name","operation","changes","conflicts"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["id","digest","expiresAt","totalWork","items","nextCursor","warnings"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/batches.get.Output/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/batches.get.Output/$defs/__schema0"}}]}}},"batches.apply.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"digest":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["digest"],"additionalProperties":false},"batches.apply.Output":{"$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)$"},"kind":{"type":"string"},"queuePosition":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"state":{"type":"string"},"title":{"type":"string"},"totalWork":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unitLabel":{"type":"string"}},"required":["id","kind","queuePosition","state","title","totalWork","unitLabel"],"additionalProperties":false},"jobs.list.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"required":[]},"jobs.list.Output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"maxItems":100,"type":"array","items":{"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)$"},"kind":{"type":"string"},"queuePosition":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"state":{"type":"string"},"title":{"type":"string"},"totalWork":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unitLabel":{"type":"string"},"cancelRequestedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"createdByCurrentUser":{"type":"boolean"},"elapsedMs":{"type":["number","null"]},"failedWork":{"type":"number"},"processedWork":{"type":"number"},"skippedWork":{"type":"number"},"startedAt":{"type":["string","null"]},"succeededWork":{"type":"number"}},"required":["id","kind","queuePosition","state","title","totalWork","unitLabel","cancelRequestedAt","completedAt","createdAt","createdByCurrentUser","elapsedMs","failedWork","processedWork","skippedWork","startedAt","succeededWork"],"additionalProperties":false}},"lastViewedAt":{"type":["string","null"]},"nextCursor":{"type":["string","null"]}},"required":["items","lastViewedAt","nextCursor"],"additionalProperties":false},"jobs.get.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"jobs.get.Output":{"$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)$"},"kind":{"type":"string"},"queuePosition":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"state":{"type":"string"},"title":{"type":"string"},"totalWork":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unitLabel":{"type":"string"},"cancelRequestedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"createdByCurrentUser":{"type":"boolean"},"elapsedMs":{"type":["number","null"]},"failedWork":{"type":"number"},"processedWork":{"type":"number"},"skippedWork":{"type":"number"},"startedAt":{"type":["string","null"]},"succeededWork":{"type":"number"},"estimatedRemainingMs":{"type":["number","null"]},"failureExamples":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"context":{"type":"array","items":{"type":"object","properties":{"attention":{"type":"boolean"},"label":{"type":"string"},"value":{"type":"string"}},"required":["attention","label","value"],"additionalProperties":false}},"label":{"type":"string"},"message":{"type":"string"},"ordinal":{"type":"number"},"outcome":{"type":"string","enum":["failed","skipped"]}},"required":["code","context","label","message","ordinal","outcome"],"additionalProperties":false}},"importRecordId":{"type":["string","null"]},"queueWaitMs":{"type":["number","null"]}},"required":["id","kind","queuePosition","state","title","totalWork","unitLabel","cancelRequestedAt","completedAt","createdAt","createdByCurrentUser","elapsedMs","failedWork","processedWork","skippedWork","startedAt","succeededWork","estimatedRemainingMs","failureExamples","importRecordId","queueWaitMs"],"additionalProperties":false},"jobs.cancel.Input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"required":[],"additionalProperties":false},"jobs.cancel.Output":{"$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)$"},"version":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"emailJobsQueued":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","emailJobsQueued"],"additionalProperties":false},"Problem":{"type":"object","required":["type","title","status","code","correlationId"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"code":{"type":"string"},"correlationId":{"type":"string","format":"uuid"}}}},"securitySchemes":{"accountOAuth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://telltell-web-789927640952.us-east1.run.app/oauth/oauth2/authorize","tokenUrl":"https://telltell-web-789927640952.us-east1.run.app/oauth/oauth2/token","refreshUrl":"https://telltell-web-789927640952.us-east1.run.app/oauth/oauth2/token","scopes":{"people:read":"people read","people:write":"people write","groups:read":"groups read","groups:write":"groups write","fields:read":"fields read","fields:write":"fields write","settings:read":"settings read","settings:write":"settings write","jobs:read":"jobs read","jobs:write":"jobs write"}}}}}}}