{"openapi":"3.1.2","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"TellTell Account API","version":"1.2.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://mcp.telltell.co/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. May queue external automatic-photo lookups when enabled. For person relationships, value is the primary/forwardLabel side and reverseValue is the reciprocal/reverseLabel side. An email released by removing a person can be used again. If that email is still retained from a removal in the last 30 days, this returns recently_removed_person rather than a server error. Only create people the user requested; never add placeholder contacts to test connectivity or discover schemas.","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 custom-field and Tags definitions in bounded pages. Relationship fields include both the configured primary (forwardLabel) and reciprocal (reverseLabel) labels, such as Parent and Child. 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. Person relationship fields require both forwardLabel and reverseLabel, such as Parent and Child; do not invent labels the user did not provide.","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":"1","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. Person relationships include relationshipPersonIds for the primary label (forwardLabel, such as Parent) and reverseRelationshipPersonIds for the reciprocal label (reverseLabel, such as Child), plus those configured labels when present. Do not invent missing labels.","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. For person relationships, value is the primary/forwardLabel side and reverseValue is the reciprocal/reverseLabel side.","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 from the account. Clears both sides of their relationship links, removes their group memberships, and releases their email addresses so those addresses can be used again. 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 and person-relationship fields. Append adds to the selected side without removing existing values; replace sets that side to the supplied list. For person relationships, value updates the primary/forwardLabel side (such as Parent) and reverseValue updates the reciprocal/reverseLabel side (such as Child). Read the field definition when a label is missing rather than inventing one.","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","forwardToReplyAddress":false,"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, current version, and both relationship labels when configured. forwardLabel is the primary side (value / relationshipPersonIds); reverseLabel is the reciprocal side (reverseValue / reverseRelationshipPersonIds). Labels are account-configured, such as Parent and Child; omit or ask when a label is missing instead of inventing one.","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. Person relationship fields keep both configured labels; supply forwardLabel and reverseLabel together and do not invent missing labels.","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":true,"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. Disabling automatic photos removes stored automatic avatars; enabling them permits external photo lookups. 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":true,"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":"Permanently cancel remaining work for a job created by this connection; canceled work cannot be resumed. 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":true,"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)$"},"type":{"type":"string","enum":["text","integer","boolean","single_choice","multi_choice","date","phone","postal_address","messaging_handle","person_relationship"]},"relationship":{"type":"object","properties":{"forwardLabel":{"type":"string","description":"Primary relationship label configured on the field, such as Parent. Use this wording for value and relationshipPersonIds. Never invent a missing label."},"reverseLabel":{"type":"string","description":"Reciprocal relationship label configured on the field, such as Child. Use this wording for reverseValue and reverseRelationshipPersonIds. Never invent a missing label."}},"required":["forwardLabel","reverseLabel"],"additionalProperties":false}},"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)$"},"description":"People on the primary side of this relationship, matching forwardLabel such as Parent."},"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)$"},"description":"People on the reciprocal side of this relationship, matching reverseLabel such as Child."},"scalarValue":{"$ref":"#/components/schemas/people.get.Output/$defs/__schema0"},"forwardLabel":{"description":"Configured primary relationship label, such as Parent. Omitted when the account has not configured it; do not invent it.","type":"string"},"reverseLabel":{"description":"Configured reciprocal relationship label, such as Child. Omitted when the account has not configured it; do not invent it.","type":"string"}},"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":{"description":"Primary-side value. For person relationships this is the forwardLabel side, such as Parent.","$ref":"#/components/schemas/people.create.Input/$defs/__schema0"},"reverseValue":{"description":"Reciprocal-side value. For person relationships this is the reverseLabel side, such as Child.","$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":{"description":"Primary-side value. For person relationships this is the forwardLabel side, such as Parent.","$ref":"#/components/schemas/people.update.Input/$defs/__schema0"},"reverseValue":{"description":"Reciprocal-side value. For person relationships this is the reverseLabel side, such as Child.","$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":{"description":"Primary-side value. For person relationships this is the forwardLabel side, such as Parent.","$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema0"},"reverseValue":{"description":"Reciprocal-side value. For person relationships this is the reverseLabel side, such as Child.","$ref":"#/components/schemas/people.fields.update.Input/$defs/__schema1"}},"required":["definitionId"],"additionalProperties":false}},"mode":{"type":"string","enum":["append","replace"],"description":"append adds values without removing existing multi-choice options or related people. replace sets the selected field or relationship side to the supplied value."}},"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"]},"forwardToReplyAddress":{"type":"boolean"},"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","forwardToReplyAddress","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"]},"forwardToReplyAddress":{"type":"boolean"},"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","description":"Primary relationship label configured on the field, such as Parent. Use this wording for value and relationshipPersonIds. Never invent a missing label."},"reverseLabel":{"type":"string","description":"Reciprocal relationship label configured on the field, such as Child. Use this wording for reverseValue and reverseRelationshipPersonIds. Never invent a missing label."}},"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,"pattern":"^[a-z0-9]+(?:_[a-z0-9]+)*$","description":"Lowercase letters and numbers separated by single underscores; no leading or trailing underscore."},"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"\\S"},"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,"pattern":"\\S","description":"Primary relationship label configured on the field, such as Parent. Use this wording for value and relationshipPersonIds. Never invent a missing label."},"reverseLabel":{"type":"string","minLength":1,"maxLength":120,"pattern":"\\S","description":"Reciprocal relationship label configured on the field, such as Child. Use this wording for reverseValue and reverseRelationshipPersonIds. Never invent a missing label."}},"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":{"description":"Required only for the other channel. The field name must equal this label.","type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},"required":["key","name","type"],"additionalProperties":false,"allOf":[{"if":{"properties":{"allowBulkEdit":{"const":true}},"required":["allowBulkEdit"]},"then":{"properties":{"type":{"enum":["single_choice","text","integer","boolean","multi_choice","date"]}}}},{"if":{"properties":{"messagingChannel":{"const":"sms"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"SMS"}}}},{"if":{"properties":{"messagingChannel":{"const":"whatsapp"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"WhatsApp"}}}},{"if":{"properties":{"messagingChannel":{"const":"signal"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Signal"}}}},{"if":{"properties":{"messagingChannel":{"const":"telegram"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Telegram"}}}},{"if":{"properties":{"messagingChannel":{"const":"discord"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Discord"}}}},{"if":{"properties":{"messagingChannel":{"const":"slack"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Slack"}}}},{"if":{"properties":{"messagingChannel":{"const":"google_chat"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Google Chat"}}}},{"if":{"properties":{"messagingChannel":{"const":"microsoft_teams"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Microsoft Teams"}}}},{"if":{"properties":{"messagingChannel":{"const":"facebook_messenger"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Facebook Messenger"}}}},{"if":{"properties":{"messagingChannel":{"const":"instagram"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"Instagram"}}}},{"if":{"properties":{"messagingChannel":{"const":"x"}},"required":["messagingChannel"]},"then":{"properties":{"name":{"const":"X (Twitter)"}}}},{"if":{"properties":{"type":{"const":"date"}},"required":["type"]},"then":{"required":["datePrecision"]},"else":{"not":{"required":["datePrecision"]}}},{"if":{"properties":{"type":{"const":"person_relationship"}},"required":["type"]},"then":{"required":["relationship"]},"else":{"not":{"required":["relationship"]}}},{"if":{"properties":{"type":{"const":"messaging_handle"}},"required":["type"]},"then":{"required":["messagingChannel"]},"else":{"not":{"required":["messagingChannel"]}}},{"if":{"properties":{"messagingChannel":{"const":"other"}},"required":["messagingChannel"]},"then":{"required":["messagingChannelLabel"]},"else":{"not":{"required":["messagingChannelLabel"]}}}]},"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,"description":"Primary relationship label configured on the field, such as Parent. Use this wording for value and relationshipPersonIds. Never invent a missing label."},"reverseLabel":{"type":"string","minLength":1,"maxLength":120,"description":"Reciprocal relationship label configured on the field, such as Child. Use this wording for reverseValue and reverseRelationshipPersonIds. Never invent a missing label."}},"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":{"description":"Primary-side value. For person relationships this is the forwardLabel side, such as Parent.","$ref":"#/components/schemas/batches.preview.Input/$defs/__schema0"},"reverseValue":{"description":"Reciprocal-side value. For person relationships this is the reverseLabel side, such as Child.","$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://mcp.telltell.co/oauth/oauth2/authorize","tokenUrl":"https://mcp.telltell.co/oauth/oauth2/token","refreshUrl":"https://mcp.telltell.co/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"}}}}}}}