{"items":[{"type":"link","label":"Introduction","link":"/openapi/v1/openapi","routeSlug":"/openapi/v1/openapi","content":{"contentType":"overview","meta":{"name":"Introduction"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/openapi/v1/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/openapi/v1/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://app.iclosed.io/support","url":"https://app.iclosed.io/support"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Proprietary","url":"https://app.iclosed.io/terms"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Introduction (1.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"V1 Public API with account based rate limiting. All requests require API key in Authorization header."}],"sectionId":"/openapi/v1/openapi"}],"sectionId":"/openapi/v1/openapi"}]}]}},{"type":"group","label":"Contacts","link":"/openapi/v1/openapi/contacts","routeSlug":"/openapi/v1/openapi/contacts","items":[{"label":"Get Contacts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/contacts/getcontacts","routeSlug":"/openapi/v1/openapi/contacts/getcontacts","metadata":{"seo":{"title":"Get Contacts","description":"List contacts for the authenticated account with pagination and filters. Query: contactId, userId, statuses, eventIds, search, limit, page, timeFrom, timeTo, orderBy, orderColumn, utmKeys, utmValues, tagIds, forSetters, setterIds, outcome, assigned, tag, isChatContact."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getContacts","name":"Get Contacts","isWebhook":false,"pointer":"/paths/~1v1~1contacts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Contacts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List contacts for the authenticated account with pagination and filters. Query: contactId, userId, statuses, eventIds, search, limit, page, timeFrom, timeTo, orderBy, orderColumn, utmKeys, utmValues, tagIds, forSetters, setterIds, outcome, assigned, tag, isChatContact."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["contacts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["contacts:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"userId","in":"query","schemaId":"schema_173","description":"Return only contacts assigned to this user ID."},{"name":"statuses","in":"query","schemaId":"schema_174","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated contact statuses to filter by. Allowed values: POTENTIAL, QUALIFIED, DISQUALIFIED, STRATEGY_CALL_BOOKED, DISCOVERY_CALL_BOOKED."},"children":[]}]}]}]},{"name":"eventIds","in":"query","schemaId":"schema_175","description":"Comma-separated event IDs to filter by (positive integers only, for example 1,2,3)."},{"name":"search","in":"query","schemaId":"schema_176","description":"Case-insensitive single search value matched across firstName, lastName, email, and phoneNumber (not comma-separated values)."},{"name":"limit","in":"query","schemaId":"schema_177","description":"Maximum contacts returned per page (1 to 100). Default is 20."},{"name":"page","in":"query","schemaId":"schema_178","description":"Zero-based page index for pagination. Default is 0."},{"name":"timeFrom","in":"query","schemaId":"schema_179","description":"Lower bound for joinedTime filtering, in ISO 8601 date-time format."},{"name":"timeTo","in":"query","schemaId":"schema_180","description":"Upper bound for joinedTime filtering, in ISO 8601 date-time format. Use with timeFrom for ranges."},{"name":"orderBy","in":"query","schemaId":"schema_181","description":"Sort direction: asc or desc. Required together with orderColumn when sorting."},{"name":"orderColumn","in":"query","schemaId":"schema_182","description":"Field to sort by: id, createdAt, updatedAt, joinedTime, firstName, lastName, or email. Required together with orderBy when sorting."}],"pointer":"/paths/~1v1~1contacts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/contacts","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"userId","in":"query","schemaId":"schema_173"},{"name":"statuses","in":"query","schemaId":"schema_174"},{"name":"eventIds","in":"query","schemaId":"schema_175"},{"name":"search","in":"query","schemaId":"schema_176"},{"name":"limit","in":"query","schemaId":"schema_177"},{"name":"page","in":"query","schemaId":"schema_178"},{"name":"timeFrom","in":"query","schemaId":"schema_179"},{"name":"timeTo","in":"query","schemaId":"schema_180"},{"name":"orderBy","in":"query","schemaId":"schema_181"},{"name":"orderColumn","in":"query","schemaId":"schema_182"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["contacts:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["contacts:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/contacts","href":"contacts/getcontacts","openApiOperationId":"getContacts","summary":"Get Contacts","securityGroups":[{"oauth2":["contacts:read"]},{"bearerAuth":["contacts:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of contacts","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_183","exampleIds":["paths/~1v1~1contacts/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_183","exampleIds":["paths/~1v1~1contacts/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1contacts/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_183","exampleIds":["paths/~1v1~1contacts/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_183","exampleIds":["paths/~1v1~1contacts/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/getcontacts"}],"panels":[]}]},"httpPath":"/v1/contacts"},{"label":"Create Contact","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/contacts/createcontact","routeSlug":"/openapi/v1/openapi/contacts/createcontact","metadata":{"seo":{"title":"Create Contact","description":"Create a new contact or updates an existing contact. Either email or phoneNumber is required."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createContact","name":"Create Contact","isWebhook":false,"pointer":"/paths/~1v1~1contacts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create Contact","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create a new contact or updates an existing contact. Either email or phoneNumber is required."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["contacts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["contacts:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_191","exampleIds":["paths/~1v1~1contacts/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_191","exampleIds":["paths/~1v1~1contacts/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1contacts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/contacts","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["contacts:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["contacts:write"]}],"requestBody":{"application/json":{"schemaId":"schema_191","exampleIds":["paths/~1v1~1contacts/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/contacts","href":"contacts/createcontact","openApiOperationId":"createContact","summary":"Create Contact","securityGroups":[{"oauth2":["contacts:write"]},{"bearerAuth":["contacts:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_191","exampleIds":["paths/~1v1~1contacts/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_191","exampleIds":["paths/~1v1~1contacts/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created contact","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Invalid input or contact already exists","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_193"}},"schemaId":"schema_193"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1contacts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_193","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_193"}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/createcontact"}],"panels":[]}]},"httpPath":"/v1/contacts"},{"label":"Update Contact","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/contacts/updatecontact","routeSlug":"/openapi/v1/openapi/contacts/updatecontact","metadata":{"seo":{"title":"Update Contact","description":"Update an existing contact by id. ⚠️ Destructive / overwrite: provided fields replace existing contact data — confirm with the user before overwriting identity or contact details."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateContact","name":"Update Contact","isWebhook":false,"pointer":"/paths/~1v1~1contacts/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update Contact","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update an existing contact by id. ⚠️ Destructive / overwrite: provided fields replace existing contact data — confirm with the user before overwriting identity or contact details."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["contacts:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["contacts:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_194","exampleIds":["paths/~1v1~1contacts/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_194","exampleIds":["paths/~1v1~1contacts/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1contacts/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/contacts","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["contacts:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["contacts:write"]}],"requestBody":{"application/json":{"schemaId":"schema_194","exampleIds":["paths/~1v1~1contacts/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/contacts","href":"contacts/updatecontact","openApiOperationId":"updateContact","summary":"Update Contact","securityGroups":[{"oauth2":["contacts:write"]},{"bearerAuth":["contacts:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_194","exampleIds":["paths/~1v1~1contacts/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_194","exampleIds":["paths/~1v1~1contacts/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully updated contact","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1contacts/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_192","exampleIds":["paths/~1v1~1contacts/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/updatecontact"}],"panels":[]}]},"httpPath":"/v1/contacts"},{"label":"Get contact by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/contacts/getcontactbyid","routeSlug":"/openapi/v1/openapi/contacts/getcontactbyid","metadata":{"seo":{"title":"Get contact by ID","description":"Get a single contact by ID. Query: contactId (required), includeUtms (optional boolean). Stats and extended info are always included for this route."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getContactById","name":"Get contact by ID","isWebhook":false,"pointer":"/paths/~1v1~1contacts~1detail/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get contact by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single contact by ID. Query: contactId (required), includeUtms (optional boolean). Stats and extended info are always included for this route."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["contacts:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["contacts:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"contactId","in":"query","schemaId":"schema_195","description":"Contact ID to fetch details for.","required":true},{"name":"includeUtms","in":"query","schemaId":"schema_196","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true, include UTMs in a flat "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"utms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array (with eventCallId per row)."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1contacts~1detail/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/contacts/detail","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"contactId","in":"query","required":true,"schemaId":"schema_195"},{"name":"includeUtms","in":"query","schemaId":"schema_196"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["contacts:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["contacts:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/contacts/detail","href":"contacts/getcontactbyid","openApiOperationId":"getContactById","summary":"Get contact by ID","securityGroups":[{"oauth2":["contacts:read"]},{"bearerAuth":["contacts:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Contact detail","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_197","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_197","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1contacts~1detail/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_197","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_197","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/getcontactbyid"}],"panels":[]}]},"httpPath":"/v1/contacts/detail"},{"label":"Get contact notes","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/contacts/getcontactnotes","routeSlug":"/openapi/v1/openapi/contacts/getcontactnotes","metadata":{"seo":{"title":"Get contact notes","description":"List notes for a contact (paginated). Query: contactId (required), limit, page, userId (optional)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getContactNotes","name":"Get contact notes","isWebhook":false,"pointer":"/paths/~1v1~1contacts~1notes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get contact notes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List notes for a contact (paginated). Query: contactId (required), limit, page, userId (optional)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["contacts.notes:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["contacts.notes:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"contactId","in":"query","schemaId":"schema_198","description":"Contact ID whose notes should be returned.","required":true},{"name":"limit","in":"query","schemaId":"schema_199","description":"Maximum notes returned per page. Default is 20."},{"name":"page","in":"query","schemaId":"schema_178","description":"Zero-based page index for pagination. Default is 0."}],"pointer":"/paths/~1v1~1contacts~1notes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/contacts/notes","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"contactId","in":"query","required":true,"schemaId":"schema_198"},{"name":"limit","in":"query","schemaId":"schema_199"},{"name":"page","in":"query","schemaId":"schema_178"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["contacts.notes:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["contacts.notes:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/contacts/notes","href":"contacts/getcontactnotes","openApiOperationId":"getContactNotes","summary":"Get contact notes","securityGroups":[{"oauth2":["contacts.notes:read"]},{"bearerAuth":["contacts.notes:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated list of contact notes with count","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_200","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_200","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1contacts~1notes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_200","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_200","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/getcontactnotes"}],"panels":[]}]},"httpPath":"/v1/contacts/notes"},{"label":"Create contact note","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/contacts/createcontactnote","routeSlug":"/openapi/v1/openapi/contacts/createcontactnote","metadata":{"seo":{"title":"Create contact note","description":"Create a note for a contact. Required: contactId, note."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createContactNote","name":"Create contact note","isWebhook":false,"pointer":"/paths/~1v1~1contacts~1notes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create contact note","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create a note for a contact. Required: contactId, note."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["contacts.notes:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["contacts.notes:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_201","exampleIds":["paths/~1v1~1contacts~1notes/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_201","exampleIds":["paths/~1v1~1contacts~1notes/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1contacts~1notes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/contacts/notes","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["contacts.notes:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["contacts.notes:write"]}],"requestBody":{"application/json":{"schemaId":"schema_201","exampleIds":["paths/~1v1~1contacts~1notes/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/contacts/notes","href":"contacts/createcontactnote","openApiOperationId":"createContactNote","summary":"Create contact note","securityGroups":[{"oauth2":["contacts.notes:write"]},{"bearerAuth":["contacts.notes:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_201","exampleIds":["paths/~1v1~1contacts~1notes/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_201","exampleIds":["paths/~1v1~1contacts~1notes/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Contact note created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_202","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_202","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1contacts~1notes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_202","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_202","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/createcontactnote"}],"panels":[]}]},"httpPath":"/v1/contacts/notes"}],"content":{"contentType":"group","meta":{"name":"Contacts"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Contacts","showPageActions":true},{"nodeType":"markdoc","content":"Contact management"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/contacts","summary":"Get Contacts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/contacts/getcontacts","deprecated":false},{"title":"/v1/contacts","summary":"Create Contact","prefix":{"name":"post","color":"post"},"badges":[],"link":"/contacts/createcontact","deprecated":false},{"title":"/v1/contacts","summary":"Update Contact","prefix":{"name":"put","color":"put"},"badges":[],"link":"/contacts/updatecontact","deprecated":false},{"title":"/v1/contacts/detail","summary":"Get contact by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/contacts/getcontactbyid","deprecated":false},{"title":"/v1/contacts/notes","summary":"Get contact notes","prefix":{"name":"get","color":"get"},"badges":[],"link":"/contacts/getcontactnotes","deprecated":false},{"title":"/v1/contacts/notes","summary":"Create contact note","prefix":{"name":"post","color":"post"},"badges":[],"link":"/contacts/createcontactnote","deprecated":false}]}]}]}]}},{"type":"group","label":"Deals","link":"/openapi/v1/openapi/deals","routeSlug":"/openapi/v1/openapi/deals","items":[{"label":"Get deals","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/deals/getdeals","routeSlug":"/openapi/v1/openapi/deals/getdeals","metadata":{"seo":{"title":"Get deals","description":"List deals for the authenticated account. Query: contactId, userIds, productIds, transactionType, limit, page, timeFrom, timeTo, and other optional filters."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getDeals","name":"Get deals","isWebhook":false,"pointer":"/paths/~1v1~1deals/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get deals","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List deals for the authenticated account. Query: contactId, userIds, productIds, transactionType, limit, page, timeFrom, timeTo, and other optional filters."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["deals:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["deals:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"contactId","in":"query","schemaId":"schema_203","description":"Filter deals linked to this contact id."},{"name":"userIds","in":"query","schemaId":"schema_204","description":"Comma-separated user ids; resolved to account user ids for filtering deals by assignee."},{"name":"productIds","in":"query","schemaId":"schema_205","description":"Comma-separated product ids; filters deals by productId in that set."},{"name":"transactionType","in":"query","schemaId":"schema_206","description":"Filter by deal transaction type (WON, RECURRING, DEPOSIT)."},{"name":"contactStatuses","in":"query","schemaId":"schema_207","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated contact status values (POTENTIAL, QUALIFIED, DISQUALIFIED, STRATEGY_CALL_BOOKED, DISCOVERY_CALL_BOOKED); filters deals whose contact status is in the list."},"children":[]}]}]}]},{"name":"eventIds","in":"query","schemaId":"schema_208","description":"Comma-separated event ids; filters deals with an eventCall tied to one of those events."},{"name":"search","in":"query","schemaId":"schema_209","description":"Case-insensitive search across provider, product name, and contact fields."},{"name":"limit","in":"query","schemaId":"schema_210","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum deals per page (1–200). Default 20."},"children":[]}]}]}]},{"name":"page","in":"query","schemaId":"schema_211","description":"Zero-based page index for pagination."},{"name":"orderBy","in":"query","schemaId":"schema_181","description":"Sort direction (asc or desc). Required together with orderColumn when sorting."},{"name":"orderColumn","in":"query","schemaId":"schema_212","description":"Deal field to sort by. Required together with orderBy when sorting."},{"name":"timeFrom","in":"query","schemaId":"schema_213","description":"Inclusive lower bound for deal time (ISO date, e.g. 2026-03-31T00:00:00.000Z)."},{"name":"timeTo","in":"query","schemaId":"schema_214","description":"Inclusive upper bound for deal time (ISO date, e.g. 2026-03-31T23:59:59.999Z)."}],"pointer":"/paths/~1v1~1deals/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/deals","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"contactId","in":"query","schemaId":"schema_203"},{"name":"userIds","in":"query","schemaId":"schema_204"},{"name":"productIds","in":"query","schemaId":"schema_205"},{"name":"transactionType","in":"query","schemaId":"schema_206"},{"name":"contactStatuses","in":"query","schemaId":"schema_207"},{"name":"eventIds","in":"query","schemaId":"schema_208"},{"name":"search","in":"query","schemaId":"schema_209"},{"name":"limit","in":"query","schemaId":"schema_210"},{"name":"page","in":"query","schemaId":"schema_211"},{"name":"orderBy","in":"query","schemaId":"schema_181"},{"name":"orderColumn","in":"query","schemaId":"schema_212"},{"name":"timeFrom","in":"query","schemaId":"schema_213"},{"name":"timeTo","in":"query","schemaId":"schema_214"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["deals:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["deals:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/deals","href":"deals/getdeals","openApiOperationId":"getDeals","summary":"Get deals","securityGroups":[{"oauth2":["deals:read"]},{"bearerAuth":["deals:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of deals with count","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_215","exampleIds":["paths/~1v1~1deals/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_215","exampleIds":["paths/~1v1~1deals/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1deals/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_215","exampleIds":["paths/~1v1~1deals/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_215","exampleIds":["paths/~1v1~1deals/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/deals/getdeals"}],"panels":[]}]},"httpPath":"/v1/deals"},{"label":"Create a new deal","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/deals/createdeal","routeSlug":"/openapi/v1/openapi/deals/createdeal","metadata":{"seo":{"title":"Create a new deal","description":"Create a new deal. Required: eventCallId. Optional: productId, productName, value, transactionType, etc."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createDeal","name":"Create a new deal","isWebhook":false,"pointer":"/paths/~1v1~1deals/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new deal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create a new deal. Required: eventCallId. Optional: productId, productName, value, transactionType, etc."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["deals:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["deals:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_216","exampleIds":["paths/~1v1~1deals/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_216","exampleIds":["paths/~1v1~1deals/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1deals/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/deals","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["deals:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["deals:write"]}],"requestBody":{"application/json":{"schemaId":"schema_216","exampleIds":["paths/~1v1~1deals/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/deals","href":"deals/createdeal","openApiOperationId":"createDeal","summary":"Create a new deal","securityGroups":[{"oauth2":["deals:write"]},{"bearerAuth":["deals:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_216","exampleIds":["paths/~1v1~1deals/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_216","exampleIds":["paths/~1v1~1deals/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created deal","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1deals/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/deals/createdeal"}],"panels":[]}]},"httpPath":"/v1/deals"},{"label":"Update a deal","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/deals/updatedeal","routeSlug":"/openapi/v1/openapi/deals/updatedeal","metadata":{"seo":{"title":"Update a deal","description":"Update an existing deal. Required: id. Optional: value, recurring, transactionType, closerId, etc."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateDeal","name":"Update a deal","isWebhook":false,"pointer":"/paths/~1v1~1deals/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a deal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update an existing deal. Required: id. Optional: value, recurring, transactionType, closerId, etc."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["deals:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["deals:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_218","exampleIds":["paths/~1v1~1deals/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_218","exampleIds":["paths/~1v1~1deals/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1deals/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/deals","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["deals:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["deals:write"]}],"requestBody":{"application/json":{"schemaId":"schema_218","exampleIds":["paths/~1v1~1deals/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/deals","href":"deals/updatedeal","openApiOperationId":"updateDeal","summary":"Update a deal","securityGroups":[{"oauth2":["deals:write"]},{"bearerAuth":["deals:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_218","exampleIds":["paths/~1v1~1deals/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_218","exampleIds":["paths/~1v1~1deals/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully updated deal","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1deals/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_217","exampleIds":["paths/~1v1~1deals/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1deals/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1deals/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1deals/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1deals/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1deals/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1deals/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/deals/updatedeal"}],"panels":[]}]},"httpPath":"/v1/deals"}],"content":{"contentType":"group","meta":{"name":"Deals"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Deals","showPageActions":true},{"nodeType":"markdoc","content":"Deal management"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/deals","summary":"Get deals","prefix":{"name":"get","color":"get"},"badges":[],"link":"/deals/getdeals","deprecated":false},{"title":"/v1/deals","summary":"Create a new deal","prefix":{"name":"post","color":"post"},"badges":[],"link":"/deals/createdeal","deprecated":false},{"title":"/v1/deals","summary":"Update a deal","prefix":{"name":"put","color":"put"},"badges":[],"link":"/deals/updatedeal","deprecated":false}]}]}]}]}},{"type":"group","label":"Events","link":"/openapi/v1/openapi/events","routeSlug":"/openapi/v1/openapi/events","items":[{"label":"Get Events","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/events/getevents","routeSlug":"/openapi/v1/openapi/events/getevents","metadata":{"seo":{"title":"Get Events","description":"List events for the authenticated account, or get a single event by id/token. Query: limit, page, id, token, search, userId, teamId, and other optional filters."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getEvents","name":"Get Events","isWebhook":false,"pointer":"/paths/~1v1~1events/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Events","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List events for the authenticated account, or get a single event by id/token. Query: limit, page, id, token, search, userId, teamId, and other optional filters."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["events:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["events:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_219","description":"Maximum number of events returned per page"},{"name":"page","in":"query","schemaId":"schema_220","description":"Zero-based page index"},{"name":"search","in":"query","schemaId":"schema_221","description":"Free-text search on event name, description, internal description, link prefix, and vanity paths (e.g. eve-2 or e/dev/eve-2)"},{"name":"userId","in":"query","schemaId":"schema_222","description":"Filter by owner/host user ID"},{"name":"eventType","in":"query","schemaId":"schema_223","description":"Filter by event type"},{"name":"latestFirst","in":"query","schemaId":"schema_224","description":"When true, events are ordered by createdAt (direction from sort when provided, else newest first)"},{"name":"sort","in":"query","schemaId":"schema_181","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sort direction when provided: orders by event name then id. When null or omitted, uses the default ordering (booking volume, or createdAt when latestFirst=true)."},"children":[]}]}]}]},{"name":"showFeatureStatuses","in":"query","schemaId":"schema_225","description":"When true, each event includes featureStatuses (disqualification, conditional routing, data intelligence) for list tooltips."}],"pointer":"/paths/~1v1~1events/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/events","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","schemaId":"schema_219"},{"name":"page","in":"query","schemaId":"schema_220"},{"name":"search","in":"query","schemaId":"schema_221"},{"name":"userId","in":"query","schemaId":"schema_222"},{"name":"eventType","in":"query","schemaId":"schema_223"},{"name":"latestFirst","in":"query","schemaId":"schema_224"},{"name":"sort","in":"query","schemaId":"schema_181"},{"name":"showFeatureStatuses","in":"query","schemaId":"schema_225"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["events:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["events:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/events","href":"events/getevents","openApiOperationId":"getEvents","summary":"Get Events","securityGroups":[{"oauth2":["events:read"]},{"bearerAuth":["events:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of events or single event","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_226","exampleIds":["paths/~1v1~1events/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_226","exampleIds":["paths/~1v1~1events/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1events/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1events/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1events/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1events/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1events/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1events/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1events/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_226","exampleIds":["paths/~1v1~1events/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_226","exampleIds":["paths/~1v1~1events/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1events/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1events/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1events/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1events/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1events/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1events/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/events/getevents"}],"panels":[]}]},"httpPath":"/v1/events"},{"label":"Get Event By ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/events/geteventbyid","routeSlug":"/openapi/v1/openapi/events/geteventbyid","metadata":{"seo":{"title":"Get Event By ID","description":"Get a single event by id for the authenticated account. Query: id (required) or linkPrefix (required)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getEventById","name":"Get Event By ID","isWebhook":false,"pointer":"/paths/~1v1~1events~1detail/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Event By ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single event by id for the authenticated account. Query: id (required) or linkPrefix (required)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["events:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["events:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"id","in":"query","schemaId":"schema_227","description":"Event ID"},{"name":"linkPrefix","in":"query","schemaId":"schema_228","description":"Event link prefix"}],"pointer":"/paths/~1v1~1events~1detail/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/events/detail","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"id","in":"query","schemaId":"schema_227"},{"name":"linkPrefix","in":"query","schemaId":"schema_228"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["events:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["events:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/events/detail","href":"events/geteventbyid","openApiOperationId":"getEventById","summary":"Get Event By ID","securityGroups":[{"oauth2":["events:read"]},{"bearerAuth":["events:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Single event detail","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_229","exampleIds":["paths/~1v1~1events~1detail/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_229","exampleIds":["paths/~1v1~1events~1detail/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1detail/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1detail/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1detail/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1detail/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1events~1detail/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_229","exampleIds":["paths/~1v1~1events~1detail/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_229","exampleIds":["paths/~1v1~1events~1detail/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1detail/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1detail/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1detail/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1detail/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/events/geteventbyid"}],"panels":[]}]},"httpPath":"/v1/events/detail"},{"label":"Update Event Status","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/events/updateeventstatus","routeSlug":"/openapi/v1/openapi/events/updateeventstatus","metadata":{"seo":{"title":"Update Event Status","description":"Update an event status to ACTIVATED or DEACTIVATED. Body: id (required), status (required). ⚠️ Destructive when status is DEACTIVATED: deactivates a live event so invitees can no longer book — confirm with the user before deactivating."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateEventStatus","name":"Update Event Status","isWebhook":false,"pointer":"/paths/~1v1~1events~1status/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update Event Status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update an event status to ACTIVATED or DEACTIVATED. Body: id (required), status (required). ⚠️ Destructive when status is DEACTIVATED: deactivates a live event so invitees can no longer book — confirm with the user before deactivating."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["events:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["events:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_230","exampleIds":["paths/~1v1~1events~1status/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_230","exampleIds":["paths/~1v1~1events~1status/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1events~1status/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/events/status","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["events:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["events:write"]}],"requestBody":{"application/json":{"schemaId":"schema_230","exampleIds":["paths/~1v1~1events~1status/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/events/status","href":"events/updateeventstatus","openApiOperationId":"updateEventStatus","summary":"Update Event Status","securityGroups":[{"oauth2":["events:write"]},{"bearerAuth":["events:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_230","exampleIds":["paths/~1v1~1events~1status/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_230","exampleIds":["paths/~1v1~1events~1status/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Event status updated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231","exampleIds":["paths/~1v1~1events~1status/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_231","exampleIds":["paths/~1v1~1events~1status/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1status/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1status/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1status/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1status/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1status/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1status/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1events~1status/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_231","exampleIds":["paths/~1v1~1events~1status/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231","exampleIds":["paths/~1v1~1events~1status/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1status/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1status/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1status/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1status/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1status/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1status/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/events/updateeventstatus"}],"panels":[]}]},"httpPath":"/v1/events/status"},{"label":"Troubleshoot Slots","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/events/troubleshootslots","routeSlug":"/openapi/v1/openapi/events/troubleshootslots","metadata":{"seo":{"title":"Troubleshoot Slots","description":"Returns time slots for an event on a given date with per-slot availability (for troubleshooting). Each slot includes a display time, optional tags/reason when unavailable (e.g. past), and lists of available and unavailable users. Query: linkPrefix (required), date (e.g. YYYY-MM-DD, required), timezone (IANA, required), selectedHost (optional)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"troubleshootSlots","name":"Troubleshoot Slots","isWebhook":false,"pointer":"/paths/~1v1~1events~1troubleshootSlots/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Troubleshoot Slots","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns time slots for an event on a given date with per-slot availability (for troubleshooting). Each slot includes a display time, optional tags/reason when unavailable (e.g. past), and lists of available and unavailable users. Query: linkPrefix (required), date (e.g. YYYY-MM-DD, required), timezone (IANA, required), selectedHost (optional)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["events:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["events:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"linkPrefix","in":"query","schemaId":"schema_232","description":"Public event link prefix","required":true},{"name":"date","in":"query","schemaId":"schema_233","description":"Date to troubleshoot","required":true},{"name":"timezone","in":"query","schemaId":"schema_234","description":"IANA timezone used for slot generation (must match app-supported timezones)","required":true},{"name":"selectedHost","in":"query","schemaId":"schema_235","description":"Optional host user ID to pin results"}],"pointer":"/paths/~1v1~1events~1troubleshootSlots/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/events/troubleshootSlots","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"linkPrefix","in":"query","required":true,"schemaId":"schema_232"},{"name":"date","in":"query","required":true,"schemaId":"schema_233"},{"name":"timezone","in":"query","required":true,"schemaId":"schema_234"},{"name":"selectedHost","in":"query","schemaId":"schema_235"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["events:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["events:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/events/troubleshootSlots","href":"events/troubleshootslots","openApiOperationId":"troubleshootSlots","summary":"Troubleshoot Slots","securityGroups":[{"oauth2":["events:read"]},{"bearerAuth":["events:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Slots for the date with available/unavailable users and count of slots that have at least one available user","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_236","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_236","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1events~1troubleshootSlots/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_236","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_236","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/events/troubleshootslots"}],"panels":[]}]},"httpPath":"/v1/events/troubleshootSlots"},{"label":"Get Event Date and Time","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/events/getpubliceventdates","routeSlug":"/openapi/v1/openapi/events/getpubliceventdates","metadata":{"seo":{"title":"Get Event Date and Time","description":"Returns available dates for public event booking. Pass conditionalUsers and routingGroupIds from insertInviteeAnswers (comma-separated). SPECIFIC_HOSTS_TEAMS may return appliedHostIds when availability waterfall widens the host pool — forward those IDs as conditionalUsers when creating the call."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPublicEventDates","name":"Get Event Date and Time","isWebhook":false,"pointer":"/paths/~1v1~1events~1eventDates/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Event Date and Time","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns available dates for public event booking. Pass conditionalUsers and routingGroupIds from insertInviteeAnswers (comma-separated). SPECIFIC_HOSTS_TEAMS may return appliedHostIds when availability waterfall widens the host pool — forward those IDs as conditionalUsers when creating the call."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["events:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["events:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_237","exampleIds":["paths/~1v1~1events~1eventDates/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_237","exampleIds":["paths/~1v1~1events~1eventDates/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1events~1eventDates/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/events/eventDates","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["events:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["events:read"]}],"requestBody":{"application/json":{"schemaId":"schema_237","exampleIds":["paths/~1v1~1events~1eventDates/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/events/eventDates","href":"events/getpubliceventdates","openApiOperationId":"getPublicEventDates","summary":"Get Event Date and Time","securityGroups":[{"oauth2":["events:read"]},{"bearerAuth":["events:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_237","exampleIds":["paths/~1v1~1events~1eventDates/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_237","exampleIds":["paths/~1v1~1events~1eventDates/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Available event dates and times by date","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_238","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_238","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1events~1eventDates/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_238","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_238","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/events/getpubliceventdates"}],"panels":[]}]},"httpPath":"/v1/events/eventDates"}],"content":{"contentType":"group","meta":{"name":"Events"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Events","showPageActions":true},{"nodeType":"markdoc","content":"Event dates and time slots"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/events","summary":"Get Events","prefix":{"name":"get","color":"get"},"badges":[],"link":"/events/getevents","deprecated":false},{"title":"/v1/events/detail","summary":"Get Event By ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/events/geteventbyid","deprecated":false},{"title":"/v1/events/status","summary":"Update Event Status","prefix":{"name":"put","color":"put"},"badges":[],"link":"/events/updateeventstatus","deprecated":false},{"title":"/v1/events/troubleshootSlots","summary":"Troubleshoot Slots","prefix":{"name":"get","color":"get"},"badges":[],"link":"/events/troubleshootslots","deprecated":false},{"title":"/v1/events/eventDates","summary":"Get Event Date and Time","prefix":{"name":"post","color":"post"},"badges":[],"link":"/events/getpubliceventdates","deprecated":false}]}]}]}]}},{"type":"group","label":"Products","link":"/openapi/v1/openapi/products","routeSlug":"/openapi/v1/openapi/products","items":[{"label":"Get Products","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/products/listproducts","routeSlug":"/openapi/v1/openapi/products/listproducts","metadata":{"seo":{"title":"Get Products","description":"List products for the authenticated account. Query: search, limit, page, parentProductId, allProducts, packageLess, timeFrom, timeTo, orderBy, orderColumn."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listProducts","name":"Get Products","isWebhook":false,"pointer":"/paths/~1v1~1products/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Products","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List products for the authenticated account. Query: search, limit, page, parentProductId, allProducts, packageLess, timeFrom, timeTo, orderBy, orderColumn."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["products:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["products:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"search","in":"query","schemaId":"schema_239","description":"Case-insensitive product name search term."},{"name":"limit","in":"query","schemaId":"schema_240","description":"Maximum number of records returned per page (1-200)."},{"name":"page","in":"query","schemaId":"schema_241","description":"Zero-based page index used with limit for pagination."},{"name":"orderBy","in":"query","schemaId":"schema_181","description":"Sort direction applied to orderColumn. Required together with orderColumn when sorting."},{"name":"orderColumn","in":"query","schemaId":"schema_242","description":"Product field used for sorting; \"deals\" sorts by related deal count. Required together with orderBy when sorting."}],"pointer":"/paths/~1v1~1products/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/products","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"search","in":"query","schemaId":"schema_239"},{"name":"limit","in":"query","schemaId":"schema_240"},{"name":"page","in":"query","schemaId":"schema_241"},{"name":"orderBy","in":"query","schemaId":"schema_181"},{"name":"orderColumn","in":"query","schemaId":"schema_242"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["products:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["products:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/products","href":"products/listproducts","openApiOperationId":"listProducts","summary":"Get Products","securityGroups":[{"oauth2":["products:read"]},{"bearerAuth":["products:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of products with count","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_243","exampleIds":["paths/~1v1~1products/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_243","exampleIds":["paths/~1v1~1products/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1products/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_243","exampleIds":["paths/~1v1~1products/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_243","exampleIds":["paths/~1v1~1products/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1products/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1products/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1products/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1products/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1products/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1products/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/products/listproducts"}],"panels":[]}]},"httpPath":"/v1/products"},{"label":"Create a new product","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/products/createproduct","routeSlug":"/openapi/v1/openapi/products/createproduct","metadata":{"seo":{"title":"Create a new product","description":"Create a new product. Required: name. Optional: description."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createProduct","name":"Create a new product","isWebhook":false,"pointer":"/paths/~1v1~1products/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new product","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create a new product. Required: name. Optional: description."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["products:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["products:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_244","exampleIds":["paths/~1v1~1products/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_244","exampleIds":["paths/~1v1~1products/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1products/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/products","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["products:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["products:write"]}],"requestBody":{"application/json":{"schemaId":"schema_244","exampleIds":["paths/~1v1~1products/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/products","href":"products/createproduct","openApiOperationId":"createProduct","summary":"Create a new product","securityGroups":[{"oauth2":["products:write"]},{"bearerAuth":["products:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_244","exampleIds":["paths/~1v1~1products/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_244","exampleIds":["paths/~1v1~1products/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created product","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_245","exampleIds":["paths/~1v1~1products/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_245","exampleIds":["paths/~1v1~1products/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1products/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_245","exampleIds":["paths/~1v1~1products/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_245","exampleIds":["paths/~1v1~1products/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1products/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1products/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1products/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1products/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1products/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1products/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/products/createproduct"}],"panels":[]}]},"httpPath":"/v1/products"},{"label":"Update a product","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/products/updateproduct","routeSlug":"/openapi/v1/openapi/products/updateproduct","metadata":{"seo":{"title":"Update a product","description":"Update an existing product. Required: productId. Optional: name, description."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateProduct","name":"Update a product","isWebhook":false,"pointer":"/paths/~1v1~1products/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a product","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update an existing product. Required: productId. Optional: name, description."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["products:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["products:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_246","exampleIds":["paths/~1v1~1products/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_246","exampleIds":["paths/~1v1~1products/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1products/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/products","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["products:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["products:write"]}],"requestBody":{"application/json":{"schemaId":"schema_246","exampleIds":["paths/~1v1~1products/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/products","href":"products/updateproduct","openApiOperationId":"updateProduct","summary":"Update a product","securityGroups":[{"oauth2":["products:write"]},{"bearerAuth":["products:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_246","exampleIds":["paths/~1v1~1products/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_246","exampleIds":["paths/~1v1~1products/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully updated product","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_245","exampleIds":["paths/~1v1~1products/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_245","exampleIds":["paths/~1v1~1products/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1products/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_245","exampleIds":["paths/~1v1~1products/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_245","exampleIds":["paths/~1v1~1products/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1products/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1products/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1products/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1products/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1products/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1products/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1products/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1products/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1products/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1products/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1products/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1products/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1products/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1products/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1products/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/products/updateproduct"}],"panels":[]}]},"httpPath":"/v1/products"}],"content":{"contentType":"group","meta":{"name":"Products"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Products","showPageActions":true},{"nodeType":"markdoc","content":"Product listing"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/products","summary":"Get Products","prefix":{"name":"get","color":"get"},"badges":[],"link":"/products/listproducts","deprecated":false},{"title":"/v1/products","summary":"Create a new product","prefix":{"name":"post","color":"post"},"badges":[],"link":"/products/createproduct","deprecated":false},{"title":"/v1/products","summary":"Update a product","prefix":{"name":"put","color":"put"},"badges":[],"link":"/products/updateproduct","deprecated":false}]}]}]}]}},{"type":"group","label":"Outcomes","link":"/openapi/v1/openapi/outcomes","routeSlug":"/openapi/v1/openapi/outcomes","items":[{"label":"Upsert Call Outcome","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/outcomes/updatetask","routeSlug":"/openapi/v1/openapi/outcomes/updatetask","metadata":{"seo":{"title":"Upsert Call Outcome","description":"Updates the outcome of a call."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateTask","name":"Upsert Call Outcome","isWebhook":false,"pointer":"/paths/~1v1~1outcomes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upsert Call Outcome","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the outcome of a call."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Body: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eventCallId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (required) identifies the event call; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"outcome"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required. Optional: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"notes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newDeal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (deal payload when posting WON)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cross-cutting validation: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"noSaleReason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"outcome"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is NO_SALE or REJECTED. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"objection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"outcome"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is WON. When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"outcome"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is NO_SALE and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"noSaleReason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is FOLLOW_UP_SCHEDULE or UNQUALIFIED, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"objection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is also required."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By event call type (server-enforced):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Discovery calls: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"outcome"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be APPROVED or REJECTED. If REJECTED, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"noSaleReason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required and must be one of NO_SHOW, BAD_FIT, OTHER, NOT_INTERESTED, CONTACT_CANCELLED, ADMIN_CANCELLED."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Strategy calls: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"outcome"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be WON or NO_SALE. If NO_SALE, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"noSaleReason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required and must be one of FOLLOW_UP_SCHEDULE, UNQUALIFIED, NO_SHOW, CONTACT_CANCELLED, ADMIN_CANCELLED, NOT_INTERESTED."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["outcomes:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["outcomes:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_247","exampleIds":["paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealManual","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealFromTransactions","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleWithReason","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleFollowUpWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryApprovedWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryRejectedBadFit"]}},"schemaId":"schema_247","exampleIds":["paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealManual","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealFromTransactions","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleWithReason","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleFollowUpWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryApprovedWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryRejectedBadFit"],"pointer":"/paths/~1v1~1outcomes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/outcomes","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["outcomes:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["outcomes:write"]}],"requestBody":{"application/json":{"schemaId":"schema_247","exampleIds":["paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealManual","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealFromTransactions","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleWithReason","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleFollowUpWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryApprovedWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryRejectedBadFit"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/outcomes","href":"outcomes/updatetask","openApiOperationId":"updateTask","summary":"Upsert Call Outcome","securityGroups":[{"oauth2":["outcomes:write"]},{"bearerAuth":["outcomes:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_247","exampleIds":["paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealManual","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealFromTransactions","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleWithReason","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleFollowUpWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryApprovedWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryRejectedBadFit"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_247","exampleIds":["paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealManual","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealFromTransactions","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleWithReason","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleFollowUpWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryApprovedWithObjection","paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryRejectedBadFit"]}},"examples":[{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Task updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_248","exampleIds":["paths/~1v1~1outcomes/post/responses/200/content/application~1json/example"]}},"schemaId":"schema_248","exampleIds":["paths/~1v1~1outcomes/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1outcomes/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1outcomes/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1outcomes/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1outcomes/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1outcomes/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1outcomes/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1outcomes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_248","exampleIds":["paths/~1v1~1outcomes/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_248","exampleIds":["paths/~1v1~1outcomes/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1outcomes/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1outcomes/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1outcomes/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1outcomes/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1outcomes/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1outcomes/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/outcomes/updatetask"}],"panels":[]}]},"httpPath":"/v1/outcomes"}],"content":{"contentType":"group","meta":{"name":"Outcomes"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Outcomes","showPageActions":true},{"nodeType":"markdoc","content":"Call outcomes"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/outcomes","summary":"Upsert Call Outcome","prefix":{"name":"post","color":"post"},"badges":[],"link":"/outcomes/updatetask","deprecated":false}]}]}]}]}},{"type":"group","label":"Fields","link":"/openapi/v1/openapi/fields","routeSlug":"/openapi/v1/openapi/fields","items":[{"label":"Create a field","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/createcustomfield","routeSlug":"/openapi/v1/openapi/fields/createcustomfield","metadata":{"seo":{"title":"Create a field","description":"Create a new custom field. Body: name (required), inputType (required), type (required), and optional identifier, description, configuration, options (array of option objects)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createCustomField","name":"Create a field","isWebhook":false,"pointer":"/paths/~1v1~1fields/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a field","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create a new custom field. Body: name (required), inputType (required), type (required), and optional identifier, description, configuration, options (array of option objects)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_249","exampleIds":["paths/~1v1~1fields/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_249","exampleIds":["paths/~1v1~1fields/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1fields/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/fields","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:write"]}],"requestBody":{"application/json":{"schemaId":"schema_249","exampleIds":["paths/~1v1~1fields/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/fields","href":"fields/createcustomfield","openApiOperationId":"createCustomField","summary":"Create a field","securityGroups":[{"oauth2":["fields:write"]},{"bearerAuth":["fields:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_249","exampleIds":["paths/~1v1~1fields/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_249","exampleIds":["paths/~1v1~1fields/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Custom field created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_250","exampleIds":["paths/~1v1~1fields/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_250","exampleIds":["paths/~1v1~1fields/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_250","exampleIds":["paths/~1v1~1fields/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_250","exampleIds":["paths/~1v1~1fields/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/createcustomfield"}],"panels":[]}]},"httpPath":"/v1/fields"},{"label":"Update a field","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/updatecustomfield","routeSlug":"/openapi/v1/openapi/fields/updatecustomfield","metadata":{"seo":{"title":"Update a field","description":"Update an existing custom field. Body: id (required), and optional name, identifier, description, inputType, type, configuration, options (array of option objects), hidden."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateCustomField","name":"Update a field","isWebhook":false,"pointer":"/paths/~1v1~1fields/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a field","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update an existing custom field. Body: id (required), and optional name, identifier, description, inputType, type, configuration, options (array of option objects), hidden."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_251","exampleIds":["paths/~1v1~1fields/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_251","exampleIds":["paths/~1v1~1fields/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1fields/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/fields","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:write"]}],"requestBody":{"application/json":{"schemaId":"schema_251","exampleIds":["paths/~1v1~1fields/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/fields","href":"fields/updatecustomfield","openApiOperationId":"updateCustomField","summary":"Update a field","securityGroups":[{"oauth2":["fields:write"]},{"bearerAuth":["fields:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_251","exampleIds":["paths/~1v1~1fields/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_251","exampleIds":["paths/~1v1~1fields/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Custom field updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_252","exampleIds":["paths/~1v1~1fields/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_252","exampleIds":["paths/~1v1~1fields/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_252","exampleIds":["paths/~1v1~1fields/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_252","exampleIds":["paths/~1v1~1fields/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/updatecustomfield"}],"panels":[]}]},"httpPath":"/v1/fields"},{"label":"Upsert Field Answer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/createcustomfieldanswer","routeSlug":"/openapi/v1/openapi/fields/createcustomfieldanswer","metadata":{"seo":{"title":"Upsert Field Answer","description":"Create or update a custom field answer for a contact (type CONTACT) or event call (type CALL). Provide exactly one of customFieldId or identifier. For CONTACT custom fields send contactId; for CALL send eventCallId. The answer array format depends on inputType: TEXT/TEXT_AREA = string(s), NUMBER/RATING/USER = numeric string(s), DATE = ISO date string, EMAIL = email string, URL = https URL, SINGLE_SELECT/MULTIPLE_SELECT = option name(s), USERS_MULTIPLE = user ID(s) as strings."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createCustomFieldAnswer","name":"Upsert Field Answer","isWebhook":false,"pointer":"/paths/~1v1~1fields~1answer/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upsert Field Answer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create or update a custom field answer for a contact (type CONTACT) or event call (type CALL). Provide exactly one of customFieldId or identifier. For CONTACT custom fields send contactId; for CALL send eventCallId. The answer array format depends on inputType: TEXT/TEXT_AREA = string(s), NUMBER/RATING/USER = numeric string(s), DATE = ISO date string, EMAIL = email string, URL = https URL, SINGLE_SELECT/MULTIPLE_SELECT = option name(s), USERS_MULTIPLE = user ID(s) as strings."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_253","exampleIds":["paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_contact","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_call"]}},"schemaId":"schema_253","exampleIds":["paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_contact","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_call"],"pointer":"/paths/~1v1~1fields~1answer/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/fields/answer","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:write"]}],"requestBody":{"application/json":{"schemaId":"schema_253","exampleIds":["paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_contact","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_call"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/fields/answer","href":"fields/createcustomfieldanswer","openApiOperationId":"createCustomFieldAnswer","summary":"Upsert Field Answer","securityGroups":[{"oauth2":["fields:write"]},{"bearerAuth":["fields:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_253","exampleIds":["paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_contact","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_call"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_253","exampleIds":["paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_NUMBER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT_AREA","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_DATE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USER","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USERS_MULTIPLE","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_URL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_SINGLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_MULTIPLE_SELECT","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_EMAIL","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_RATING","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_contact","paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_call"]}},"examples":[{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Custom field answer created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_254","exampleIds":["paths/~1v1~1fields~1answer/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_254","exampleIds":["paths/~1v1~1fields~1answer/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields~1answer/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_254","exampleIds":["paths/~1v1~1fields~1answer/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_254","exampleIds":["paths/~1v1~1fields~1answer/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/createcustomfieldanswer"}],"panels":[]}]},"httpPath":"/v1/fields/answer"},{"label":"Bulk Upsert Field Answers (Contacts)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/bulkcreatecustomfieldanswer","routeSlug":"/openapi/v1/openapi/fields/bulkcreatecustomfieldanswer","metadata":{"seo":{"title":"Bulk Upsert Field Answers (Contacts)","description":"Create or update a custom field answer for multiple contacts (CONTACT-type fields only). Provide exactly one of customFieldId or identifier and a non-empty contactIds array (max 10,000). Answer format matches POST /v1/fields/answer."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"bulkCreateCustomFieldAnswer","name":"Bulk Upsert Field Answers (Contacts)","isWebhook":false,"pointer":"/paths/~1v1~1fields~1answer~1bulk/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bulk Upsert Field Answers (Contacts)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create or update a custom field answer for multiple contacts (CONTACT-type fields only). Provide exactly one of customFieldId or identifier and a non-empty contactIds array (max 10,000). Answer format matches POST /v1/fields/answer."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_255","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/requestBody/content/application~1json/examples/contact_TEXT_bulk"]}},"schemaId":"schema_255","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/requestBody/content/application~1json/examples/contact_TEXT_bulk"],"pointer":"/paths/~1v1~1fields~1answer~1bulk/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/fields/answer/bulk","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:write"]}],"requestBody":{"application/json":{"schemaId":"schema_255","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/requestBody/content/application~1json/examples/contact_TEXT_bulk"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/fields/answer/bulk","href":"fields/bulkcreatecustomfieldanswer","openApiOperationId":"bulkCreateCustomFieldAnswer","summary":"Bulk Upsert Field Answers (Contacts)","securityGroups":[{"oauth2":["fields:write"]},{"bearerAuth":["fields:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_255","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/requestBody/content/application~1json/examples/contact_TEXT_bulk"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_255","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/requestBody/content/application~1json/examples/contact_TEXT_bulk"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Custom field answers created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_256","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_256","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields~1answer~1bulk/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_256","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_256","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/bulkcreatecustomfieldanswer"}],"panels":[]}]},"httpPath":"/v1/fields/answer/bulk"},{"label":"Insert Invitee Answers","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/insertinviteeanswers","routeSlug":"/openapi/v1/openapi/fields/insertinviteeanswers","metadata":{"seo":{"title":"Insert Invitee Answers","description":"Insert invitee question answers and secondary (custom field) answers for a contact on an event (disqualified lead flow). Secondary questions can be identified by customFieldId or identifier; answer is always an array. Backend resolves secondary answers to the event's custom fields and computes disqualifyingCondition, conditionalUsers, routingGroupIds, and routingMode from event logic (disqualification and conditional routing). Echo conditionalUsers and routingGroupIds (comma-separated) to eventDates and create. If eventDates returns appliedHostIds, use those as conditionalUsers when booking."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"insertInviteeAnswers","name":"Insert Invitee Answers","isWebhook":false,"pointer":"/paths/~1v1~1fields~1inviteeAnswers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Insert Invitee Answers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Insert invitee question answers and secondary (custom field) answers for a contact on an event (disqualified lead flow). Secondary questions can be identified by customFieldId or identifier; answer is always an array. Backend resolves secondary answers to the event's custom fields and computes disqualifyingCondition, conditionalUsers, routingGroupIds, and routingMode from event logic (disqualification and conditional routing). Echo conditionalUsers and routingGroupIds (comma-separated) to eventDates and create. If eventDates returns appliedHostIds, use those as conditionalUsers when booking."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_257","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_257","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1fields~1inviteeAnswers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/fields/inviteeAnswers","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:write"]}],"requestBody":{"application/json":{"schemaId":"schema_257","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/fields/inviteeAnswers","href":"fields/insertinviteeanswers","openApiOperationId":"insertInviteeAnswers","summary":"Insert Invitee Answers","securityGroups":[{"oauth2":["fields:write"]},{"bearerAuth":["fields:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_257","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_257","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Answers inserted; returns message, disqualifyingCondition, conditionalUsers, routingGroupIds, and routingMode","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_258","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields~1inviteeAnswers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_258","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/insertinviteeanswers"}],"panels":[]}]},"httpPath":"/v1/fields/inviteeAnswers"},{"label":"Get Contact Stages","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/getcontactstage","routeSlug":"/openapi/v1/openapi/fields/getcontactstage","metadata":{"seo":{"title":"Get Contact Stages","description":"Retrieve the Contact Stages (lifecycle stages) custom field for the authenticated account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getContactStage","name":"Get Contact Stages","isWebhook":false,"pointer":"/paths/~1v1~1fields~1contact-stage/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Contact Stages","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve the Contact Stages (lifecycle stages) custom field for the authenticated account."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/fields/contact-stage","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/fields/contact-stage","href":"fields/getcontactstage","openApiOperationId":"getContactStage","summary":"Get Contact Stages","securityGroups":[{"oauth2":["fields:read"]},{"bearerAuth":["fields:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Contact Stage field with options","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_259","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_259","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields~1contact-stage/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_259","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_259","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/getcontactstage"}],"panels":[]}]},"httpPath":"/v1/fields/contact-stage"},{"label":"Get Object and Fields","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/getcustomfieldsbyobjecttype","routeSlug":"/openapi/v1/openapi/fields/getcustomfieldsbyobjecttype","metadata":{"seo":{"title":"Get Object and Fields","description":"Get paginated custom fields for a specific object type. Query: objectType (required), page, limit, search, inputType, hidden, showSystemFields, allFields, forFilters, inviteeQuestions, includeRelations, identifiers."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCustomFieldsByObjectType","name":"Get Object and Fields","isWebhook":false,"pointer":"/paths/~1v1~1fields~1objects/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Object and Fields","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get paginated custom fields for a specific object type. Query: objectType (required), page, limit, search, inputType, hidden, showSystemFields, allFields, forFilters, inviteeQuestions, includeRelations, identifiers."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"objectType","in":"query","schemaId":"schema_260","description":"Object type to filter fields by.","required":true},{"name":"page","in":"query","schemaId":"schema_261","description":"Zero-based page index."},{"name":"limit","in":"query","schemaId":"schema_262","description":"Maximum number of fields returned per page."},{"name":"search","in":"query","schemaId":"schema_263","description":"Search term applied on field name/identifier in service layer."},{"name":"inputType","in":"query","schemaId":"schema_264","description":"Filter fields by input type."},{"name":"showSystemFields","in":"query","schemaId":"schema_225","description":"Whether system fields should be included."},{"name":"inviteeQuestions","in":"query","schemaId":"schema_225","description":"Whether to filter by invitee-question flag in service layer."},{"name":"identifiers","in":"query","schemaId":"schema_265","description":"Comma-separated field identifiers filter."}],"pointer":"/paths/~1v1~1fields~1objects/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/fields/objects","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"objectType","in":"query","required":true,"schemaId":"schema_260"},{"name":"page","in":"query","schemaId":"schema_261"},{"name":"limit","in":"query","schemaId":"schema_262"},{"name":"search","in":"query","schemaId":"schema_263"},{"name":"inputType","in":"query","schemaId":"schema_264"},{"name":"showSystemFields","in":"query","schemaId":"schema_225"},{"name":"inviteeQuestions","in":"query","schemaId":"schema_225"},{"name":"identifiers","in":"query","schemaId":"schema_265"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/fields/objects","href":"fields/getcustomfieldsbyobjecttype","openApiOperationId":"getCustomFieldsByObjectType","summary":"Get Object and Fields","securityGroups":[{"oauth2":["fields:read"]},{"bearerAuth":["fields:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Paginated custom fields for the object type","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_266","exampleIds":["paths/~1v1~1fields~1objects/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_266","exampleIds":["paths/~1v1~1fields~1objects/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields~1objects/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_266","exampleIds":["paths/~1v1~1fields~1objects/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_266","exampleIds":["paths/~1v1~1fields~1objects/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/getcustomfieldsbyobjecttype"}],"panels":[]}]},"httpPath":"/v1/fields/objects"},{"label":"Get All Objects and Fields","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/fields/getallobjecttypescustomfields","routeSlug":"/openapi/v1/openapi/fields/getallobjecttypescustomfields","metadata":{"seo":{"title":"Get All Objects and Fields","description":"Get custom fields for all object types (CONTACT, CALL, EVENT, DEAL, USER, etc.) in one response. Query: page, limit, search, inputType, hidden, showSystemFields, allFields, forFilters, inviteeQuestions."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllObjectTypesCustomFields","name":"Get All Objects and Fields","isWebhook":false,"pointer":"/paths/~1v1~1fields~1objects~1all/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Objects and Fields","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get custom fields for all object types (CONTACT, CALL, EVENT, DEAL, USER, etc.) in one response. Query: page, limit, search, inputType, hidden, showSystemFields, allFields, forFilters, inviteeQuestions."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["fields:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["fields:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_261","description":"Zero-based page index."},{"name":"limit","in":"query","schemaId":"schema_267","description":"Maximum number of items per object-type slice."},{"name":"search","in":"query","schemaId":"schema_268","description":"Search term applied in service layer."},{"name":"inputType","in":"query","schemaId":"schema_264","description":"Filter by input type across object types."},{"name":"showSystemFields","in":"query","schemaId":"schema_225","description":"Whether to include system fields."},{"name":"inviteeQuestions","in":"query","schemaId":"schema_225","description":"Whether to filter by invitee-question behavior."}],"pointer":"/paths/~1v1~1fields~1objects~1all/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/fields/objects/all","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"page","in":"query","schemaId":"schema_261"},{"name":"limit","in":"query","schemaId":"schema_267"},{"name":"search","in":"query","schemaId":"schema_268"},{"name":"inputType","in":"query","schemaId":"schema_264"},{"name":"showSystemFields","in":"query","schemaId":"schema_225"},{"name":"inviteeQuestions","in":"query","schemaId":"schema_225"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["fields:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["fields:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/fields/objects/all","href":"fields/getallobjecttypescustomfields","openApiOperationId":"getAllObjectTypesCustomFields","summary":"Get All Objects and Fields","securityGroups":[{"oauth2":["fields:read"]},{"bearerAuth":["fields:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Custom fields grouped by object type","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_269","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_269","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1fields~1objects~1all/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_269","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_269","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fields/getallobjecttypescustomfields"}],"panels":[]}]},"httpPath":"/v1/fields/objects/all"}],"content":{"contentType":"group","meta":{"name":"Fields"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fields","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/fields","summary":"Create a field","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fields/createcustomfield","deprecated":false},{"title":"/v1/fields","summary":"Update a field","prefix":{"name":"put","color":"put"},"badges":[],"link":"/fields/updatecustomfield","deprecated":false},{"title":"/v1/fields/answer","summary":"Upsert Field Answer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fields/createcustomfieldanswer","deprecated":false},{"title":"/v1/fields/answer/bulk","summary":"Bulk Upsert Field Answers (Contacts)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fields/bulkcreatecustomfieldanswer","deprecated":false},{"title":"/v1/fields/inviteeAnswers","summary":"Insert Invitee Answers","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fields/insertinviteeanswers","deprecated":false},{"title":"/v1/fields/contact-stage","summary":"Get Contact Stages","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fields/getcontactstage","deprecated":false},{"title":"/v1/fields/objects","summary":"Get Object and Fields","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fields/getcustomfieldsbyobjecttype","deprecated":false},{"title":"/v1/fields/objects/all","summary":"Get All Objects and Fields","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fields/getallobjecttypescustomfields","deprecated":false}]}]}]}]}},{"type":"group","label":"Calls","link":"/openapi/v1/openapi/calls","routeSlug":"/openapi/v1/openapi/calls","items":[{"label":"Create Call","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/calls/createeventcall","routeSlug":"/openapi/v1/openapi/calls/createeventcall","metadata":{"seo":{"title":"Create Call","description":"Create a new event call with minimal payload. Adapter gets accountId from auth, validates event/contact belong to account, and fills invitee answers from contact. Optional secondaryQuestionsAnswer: identify each item by customFieldId or identifier; answer is always an array of strings (one element for single-value types, multiple for MULTIPLE_SELECT). Echo routingGroupIds and conditionalUsers from insertInviteeAnswers; if getPublicEventDates returned appliedHostIds, pass those as conditionalUsers."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createEventCall","name":"Create Call","isWebhook":false,"pointer":"/paths/~1v1~1eventCalls/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create Call","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new event call with minimal payload. Adapter gets accountId from auth, validates event/contact belong to account, and fills invitee answers from contact. Optional secondaryQuestionsAnswer: identify each item by customFieldId or identifier; answer is always an array of strings (one element for single-value types, multiple for MULTIPLE_SELECT). Echo routingGroupIds and conditionalUsers from insertInviteeAnswers; if getPublicEventDates returned appliedHostIds, pass those as conditionalUsers."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["eventCalls:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["eventCalls:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_270","exampleIds":["paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byEventAndContactIds","paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byLinkPrefixAndIdentifiers"]}},"schemaId":"schema_270","exampleIds":["paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byEventAndContactIds","paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byLinkPrefixAndIdentifiers"],"pointer":"/paths/~1v1~1eventCalls/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/eventCalls","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["eventCalls:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["eventCalls:write"]}],"requestBody":{"application/json":{"schemaId":"schema_270","exampleIds":["paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byEventAndContactIds","paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byLinkPrefixAndIdentifiers"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/eventCalls","href":"calls/createeventcall","openApiOperationId":"createEventCall","summary":"Create Call","securityGroups":[{"oauth2":["eventCalls:write"]},{"bearerAuth":["eventCalls:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_270","exampleIds":["paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byEventAndContactIds","paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byLinkPrefixAndIdentifiers"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_270","exampleIds":["paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byEventAndContactIds","paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byLinkPrefixAndIdentifiers"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Event call created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_271","exampleIds":["paths/~1v1~1eventCalls/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_271","exampleIds":["paths/~1v1~1eventCalls/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1eventCalls/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_271","exampleIds":["paths/~1v1~1eventCalls/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_271","exampleIds":["paths/~1v1~1eventCalls/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/calls/createeventcall"}],"panels":[]}]},"httpPath":"/v1/eventCalls"},{"label":"Get Calls","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/calls/searcheventcall","routeSlug":"/openapi/v1/openapi/calls/searcheventcall","metadata":{"seo":{"title":"Get Calls","description":"Search event calls. Supports single filters (id, eventId, userId, contactId, previewId, dateTime), location filter (comma-separated location values), scheduled date range (dateFrom, dateTo), creation date range (createdAtStart, createdAtEnd), eventType (e.g. PAST, UPCOMING, ALL), pagination (limit, page), ordering (orderColumn: createdAt | dateTime | updatedAt | id with orderBy: asc | desc), and comma-separated lists (ids, userIds, teamIds, eventIds, types, inviteeEmails, outcomes, noSaleReason, utmKeys, utmValues, callTypes, setterIds). Caller parses comma-separated values."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"searchEventCall","name":"Get Calls","isWebhook":false,"pointer":"/paths/~1v1~1eventCalls/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Calls","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search event calls. Supports single filters (id, eventId, userId, contactId, previewId, dateTime), location filter (comma-separated location values), scheduled date range (dateFrom, dateTo), creation date range (createdAtStart, createdAtEnd), eventType (e.g. PAST, UPCOMING, ALL), pagination (limit, page), ordering (orderColumn: createdAt | dateTime | updatedAt | id with orderBy: asc | desc), and comma-separated lists (ids, userIds, teamIds, eventIds, types, inviteeEmails, outcomes, noSaleReason, utmKeys, utmValues, callTypes, setterIds). Caller parses comma-separated values."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["eventCalls:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["eventCalls:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"ids","in":"query","schemaId":"schema_272","description":"Comma-separated event call IDs to include"},{"name":"contactId","in":"query","schemaId":"schema_273","description":"Filter by contact ID"},{"name":"eventType","in":"query","schemaId":"schema_274","description":"Time-window filter: PAST, UPCOMING, or ALL"},{"name":"search","in":"query","schemaId":"schema_275","description":"Free-text search across invitee/contact name, email, and phone"},{"name":"dateFrom","in":"query","schemaId":"schema_276","description":"Start of date range filter (inclusive)"},{"name":"dateTo","in":"query","schemaId":"schema_277","description":"End of date range filter (inclusive)"},{"name":"createdAtStart","in":"query","schemaId":"schema_278","description":"Start of creation date range filter (inclusive)"},{"name":"createdAtEnd","in":"query","schemaId":"schema_279","description":"End of creation date range filter (inclusive)"},{"name":"location","in":"query","schemaId":"schema_280","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated location filter values (e.g. PHONE_CALL,GOOGLE_MEET)"},"children":[]}]}]}]},{"name":"orderColumn","in":"query","schemaId":"schema_281","description":"Sort column for result ordering: createdAt, dateTime, updatedAt, id"},{"name":"orderBy","in":"query","schemaId":"schema_181","description":"Sort direction: asc or desc. Required together with orderColumn when sorting"},{"name":"limit","in":"query","schemaId":"schema_282","description":"Maximum number of records per page"},{"name":"page","in":"query","schemaId":"schema_220","description":"Zero-based page index"},{"name":"userIds","in":"query","schemaId":"schema_283","description":"Comma-separated assigned user IDs"},{"name":"eventIds","in":"query","schemaId":"schema_284","description":"Comma-separated event template IDs"},{"name":"types","in":"query","schemaId":"schema_285","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: rescheduled_events, cancelled_events, scheduled_events"},"children":[]}]}]}]},{"name":"inviteeEmails","in":"query","schemaId":"schema_286","description":"Comma-separated invitee email addresses"},{"name":"outcomes","in":"query","schemaId":"schema_287","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: WON, NO_SALE, QUALIFIED, UNQUALIFIED, PENDING, APPROVED, REJECTED, PENDING_OUTCOME"},"children":[]}]}]}]},{"name":"noSaleReason","in":"query","schemaId":"schema_288","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: FOLLOW_UP_SCHEDULE, UNQUALIFIED, NO_SHOW, CONTACT_CANCELLED, ADMIN_CANCELLED, NOT_INTERESTED, BAD_FIT, OTHER"},"children":[]}]}]}]},{"name":"utmKeys","in":"query","schemaId":"schema_289","description":"Comma-separated UTM parameter keys to filter by"},{"name":"utmValues","in":"query","schemaId":"schema_290","description":"Comma-separated UTM parameter values to filter by"},{"name":"callTypes","in":"query","schemaId":"schema_291","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: STRATEGY_EVENT, DISCOVERY_EVENT"},"children":[]}]}]}]},{"name":"setterIds","in":"query","schemaId":"schema_292","description":"Comma-separated setter user IDs linked via SettedClaim"}],"pointer":"/paths/~1v1~1eventCalls/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/eventCalls","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"ids","in":"query","schemaId":"schema_272"},{"name":"contactId","in":"query","schemaId":"schema_273"},{"name":"eventType","in":"query","schemaId":"schema_274"},{"name":"search","in":"query","schemaId":"schema_275"},{"name":"dateFrom","in":"query","schemaId":"schema_276"},{"name":"dateTo","in":"query","schemaId":"schema_277"},{"name":"createdAtStart","in":"query","schemaId":"schema_278"},{"name":"createdAtEnd","in":"query","schemaId":"schema_279"},{"name":"location","in":"query","schemaId":"schema_280"},{"name":"orderColumn","in":"query","schemaId":"schema_281"},{"name":"orderBy","in":"query","schemaId":"schema_181"},{"name":"limit","in":"query","schemaId":"schema_282"},{"name":"page","in":"query","schemaId":"schema_220"},{"name":"userIds","in":"query","schemaId":"schema_283"},{"name":"eventIds","in":"query","schemaId":"schema_284"},{"name":"types","in":"query","schemaId":"schema_285"},{"name":"inviteeEmails","in":"query","schemaId":"schema_286"},{"name":"outcomes","in":"query","schemaId":"schema_287"},{"name":"noSaleReason","in":"query","schemaId":"schema_288"},{"name":"utmKeys","in":"query","schemaId":"schema_289"},{"name":"utmValues","in":"query","schemaId":"schema_290"},{"name":"callTypes","in":"query","schemaId":"schema_291"},{"name":"setterIds","in":"query","schemaId":"schema_292"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["eventCalls:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["eventCalls:read"]}],"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/eventCalls","href":"calls/searcheventcall","openApiOperationId":"searchEventCall","summary":"Get Calls","securityGroups":[{"oauth2":["eventCalls:read"]},{"bearerAuth":["eventCalls:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"List of event calls with count","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_293","exampleIds":["paths/~1v1~1eventCalls/get/responses/201/content/application~1json/example"]}},"schemaId":"schema_293","exampleIds":["paths/~1v1~1eventCalls/get/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1eventCalls/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_293","exampleIds":["paths/~1v1~1eventCalls/get/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_293","exampleIds":["paths/~1v1~1eventCalls/get/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/calls/searcheventcall"}],"panels":[]}]},"httpPath":"/v1/eventCalls"},{"label":"Reschedule Call","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/calls/rescheduleeventcall","routeSlug":"/openapi/v1/openapi/calls/rescheduleeventcall","metadata":{"seo":{"title":"Reschedule Call","description":"Reschedule an existing event call. Body: id, dateTime, timeZone, rescheduleReason, notes, userId."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"rescheduleEventCall","name":"Reschedule Call","isWebhook":false,"pointer":"/paths/~1v1~1eventCalls~1reschedule/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reschedule Call","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Reschedule an existing event call. Body: id, dateTime, timeZone, rescheduleReason, notes, userId."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["eventCalls:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["eventCalls:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_294","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_294","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1eventCalls~1reschedule/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/eventCalls/reschedule","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["eventCalls:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["eventCalls:write"]}],"requestBody":{"application/json":{"schemaId":"schema_294","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/eventCalls/reschedule","href":"calls/rescheduleeventcall","openApiOperationId":"rescheduleEventCall","summary":"Reschedule Call","securityGroups":[{"oauth2":["eventCalls:write"]},{"bearerAuth":["eventCalls:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_294","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_294","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Call rescheduled","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_295","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_295","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1eventCalls~1reschedule/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_295","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_295","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/calls/rescheduleeventcall"}],"panels":[]}]},"httpPath":"/v1/eventCalls/reschedule"},{"label":"Cancel Call","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/calls/canceleventcall","routeSlug":"/openapi/v1/openapi/calls/canceleventcall","metadata":{"seo":{"title":"Cancel Call","description":"⚠️ Destructive / irreversible: cancels a scheduled event call (invitees lose the booking). id is required. Optional: cancelReason. Confirm with the user before calling."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancelEventCall","name":"Cancel Call","isWebhook":false,"pointer":"/paths/~1v1~1eventCalls~1cancel/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel Call","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚠️ Destructive / irreversible: cancels a scheduled event call (invitees lose the booking). id is required. Optional: cancelReason. Confirm with the user before calling."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["eventCalls:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["eventCalls:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_296","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_296","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1eventCalls~1cancel/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/eventCalls/cancel","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["eventCalls:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["eventCalls:write"]}],"requestBody":{"application/json":{"schemaId":"schema_296","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/eventCalls/cancel","href":"calls/canceleventcall","openApiOperationId":"cancelEventCall","summary":"Cancel Call","securityGroups":[{"oauth2":["eventCalls:write"]},{"bearerAuth":["eventCalls:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_296","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_296","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Call cancelled","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_297","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_297","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1eventCalls~1cancel/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_297","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_297","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/calls/canceleventcall"}],"panels":[]}]},"httpPath":"/v1/eventCalls/cancel"},{"label":"Mark Booked Slot as Free","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/calls/updateslotfree","routeSlug":"/openapi/v1/openapi/calls/updateslotfree","metadata":{"seo":{"title":"Mark Booked Slot as Free","description":"⚠️ Destructive / irreversible calendar visibility change: marks a booked event-call slot free (transparent) or busy (opaque). Confirm with the user before changing calendar opacity for a live booking. Required: id (event call ID), isSlotFree (boolean)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateSlotFree","name":"Mark Booked Slot as Free","isWebhook":false,"pointer":"/paths/~1v1~1eventCalls~1markSlotFree/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mark Booked Slot as Free","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚠️ Destructive / irreversible calendar visibility change: marks a booked event-call slot free (transparent) or busy (opaque). Confirm with the user before changing calendar opacity for a live booking. Required: id (event call ID), isSlotFree (boolean)."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["eventCalls:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["eventCalls:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_298","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_298","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1eventCalls~1markSlotFree/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/eventCalls/markSlotFree","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["eventCalls:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["eventCalls:write"]}],"requestBody":{"application/json":{"schemaId":"schema_298","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/eventCalls/markSlotFree","href":"calls/updateslotfree","openApiOperationId":"updateSlotFree","summary":"Mark Booked Slot as Free","securityGroups":[{"oauth2":["eventCalls:write"]},{"bearerAuth":["eventCalls:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_298","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_298","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Slot free status updated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_299","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_299","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1eventCalls~1markSlotFree/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_299","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_299","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/calls/updateslotfree"}],"panels":[]}]},"httpPath":"/v1/eventCalls/markSlotFree"}],"content":{"contentType":"group","meta":{"name":"Calls"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Calls","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/eventCalls","summary":"Create Call","prefix":{"name":"post","color":"post"},"badges":[],"link":"/calls/createeventcall","deprecated":false},{"title":"/v1/eventCalls","summary":"Get Calls","prefix":{"name":"get","color":"get"},"badges":[],"link":"/calls/searcheventcall","deprecated":false},{"title":"/v1/eventCalls/reschedule","summary":"Reschedule Call","prefix":{"name":"put","color":"put"},"badges":[],"link":"/calls/rescheduleeventcall","deprecated":false},{"title":"/v1/eventCalls/cancel","summary":"Cancel Call","prefix":{"name":"put","color":"put"},"badges":[],"link":"/calls/canceleventcall","deprecated":false},{"title":"/v1/eventCalls/markSlotFree","summary":"Mark Booked Slot as Free","prefix":{"name":"put","color":"put"},"badges":[],"link":"/calls/updateslotfree","deprecated":false}]}]}]}]}},{"type":"group","label":"Transactions","link":"/openapi/v1/openapi/transactions","routeSlug":"/openapi/v1/openapi/transactions","items":[{"label":"Get transactions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/transactions/gettransactions","routeSlug":"/openapi/v1/openapi/transactions/gettransactions","metadata":{"seo":{"title":"Get transactions","description":"List transactions with optional filters (id, synced, search, source, time range, pagination, sort)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTransactions","name":"Get transactions","isWebhook":false,"pointer":"/paths/~1v1~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get transactions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List transactions with optional filters (id, synced, search, source, time range, pagination, sort)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["transactions:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["transactions:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"id","in":"query","schemaId":"schema_300","description":"Filter by transaction ID."},{"name":"synced","in":"query","schemaId":"schema_225","description":"Filter by synced-to-deal status."},{"name":"search","in":"query","schemaId":"schema_301","description":"Search in name, email, phoneNumber, or value."},{"name":"source","in":"query","schemaId":"schema_302","description":"Filter by source (e.g. \"Zapier\"). Comma-separated for multiple."},{"name":"timeFrom","in":"query","schemaId":"schema_303","description":"Filter transactions created on or after this time (ISO 8601)."},{"name":"timeTo","in":"query","schemaId":"schema_304","description":"Filter by createdAt on or before this time (ISO 8601)."},{"name":"page","in":"query","schemaId":"schema_305","description":"Page index for pagination (0-based)."},{"name":"limit","in":"query","schemaId":"schema_306","description":"Number of items per page."},{"name":"sort","in":"query","schemaId":"schema_181","description":"Sort order by createdAt."},{"name":"sortByAmount","in":"query","schemaId":"schema_307","description":"Sort by transaction value amount: ascending or descending."}],"pointer":"/paths/~1v1~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/transactions","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"id","in":"query","schemaId":"schema_300"},{"name":"synced","in":"query","schemaId":"schema_225"},{"name":"search","in":"query","schemaId":"schema_301"},{"name":"source","in":"query","schemaId":"schema_302"},{"name":"timeFrom","in":"query","schemaId":"schema_303"},{"name":"timeTo","in":"query","schemaId":"schema_304"},{"name":"page","in":"query","schemaId":"schema_305"},{"name":"limit","in":"query","schemaId":"schema_306"},{"name":"sort","in":"query","schemaId":"schema_181"},{"name":"sortByAmount","in":"query","schemaId":"schema_307"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["transactions:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["transactions:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/transactions","href":"transactions/gettransactions","openApiOperationId":"getTransactions","summary":"Get transactions","securityGroups":[{"oauth2":["transactions:read"]},{"bearerAuth":["transactions:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction list with count","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_308","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_308","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_308","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_308","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/gettransactions"}],"panels":[]}]},"httpPath":"/v1/transactions"},{"label":"Create a transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/transactions/createtransaction","routeSlug":"/openapi/v1/openapi/transactions/createtransaction","metadata":{"seo":{"title":"Create a transaction","description":"Create a new transaction. Value is required."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createTransaction","name":"Create a transaction","isWebhook":false,"pointer":"/paths/~1v1~1transactions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create a new transaction. Value is required."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["transactions:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_309","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_309","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1transactions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/transactions","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["transactions:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["transactions:write"]}],"requestBody":{"application/json":{"schemaId":"schema_309","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","429","500"],"pointer":"/v1/transactions","href":"transactions/createtransaction","openApiOperationId":"createTransaction","summary":"Create a transaction","securityGroups":[{"oauth2":["transactions:write"]},{"bearerAuth":["transactions:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_309","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_309","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created transaction","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_310","exampleIds":["paths/~1v1~1transactions/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_310","exampleIds":["paths/~1v1~1transactions/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/post/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/post/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1transactions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_310","exampleIds":["paths/~1v1~1transactions/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_310","exampleIds":["paths/~1v1~1transactions/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/createtransaction"}],"panels":[]}]},"httpPath":"/v1/transactions"},{"label":"Update a transaction","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/transactions/updatetransaction","routeSlug":"/openapi/v1/openapi/transactions/updatetransaction","metadata":{"seo":{"title":"Update a transaction","description":"Update an existing transaction by id. Id is required in body."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateTransaction","name":"Update a transaction","isWebhook":false,"pointer":"/paths/~1v1~1transactions/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update an existing transaction by id. Id is required in body."},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["transactions:write"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["transactions:write"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_311","exampleIds":["paths/~1v1~1transactions/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_311","exampleIds":["paths/~1v1~1transactions/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1transactions/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/transactions","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["transactions:write"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["transactions:write"]}],"requestBody":{"application/json":{"schemaId":"schema_311","exampleIds":["paths/~1v1~1transactions/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/transactions","href":"transactions/updatetransaction","openApiOperationId":"updateTransaction","summary":"Update a transaction","securityGroups":[{"oauth2":["transactions:write"]},{"bearerAuth":["transactions:write"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"schemaId":"schema_311","exampleIds":["paths/~1v1~1transactions/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_311","exampleIds":["paths/~1v1~1transactions/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully updated transaction","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_312","exampleIds":["paths/~1v1~1transactions/put/responses/200/content/application~1json/example"]}},"schemaId":"schema_312","exampleIds":["paths/~1v1~1transactions/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/put/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/put/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/put/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/put/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/put/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/put/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1transactions/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_312","exampleIds":["paths/~1v1~1transactions/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_312","exampleIds":["paths/~1v1~1transactions/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/put/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/put/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/put/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/put/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/put/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/updatetransaction"}],"panels":[]}]},"httpPath":"/v1/transactions"},{"label":"Delete a transaction","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/transactions/deletetransaction","routeSlug":"/openapi/v1/openapi/transactions/deletetransaction","metadata":{"seo":{"title":"Delete a transaction","description":"⚠️ Destructive / irreversible: permanently deletes a transaction by id (query param). Confirm with the user before calling. Do not use for cleanup unless explicitly requested."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteTransaction","name":"Delete a transaction","isWebhook":false,"pointer":"/paths/~1v1~1transactions/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚠️ Destructive / irreversible: permanently deletes a transaction by id (query param). Confirm with the user before calling. Do not use for cleanup unless explicitly requested."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["transactions:delete"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["transactions:delete"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"id","in":"query","schemaId":"schema_313","required":true}],"pointer":"/paths/~1v1~1transactions/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/v1/transactions","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"id","in":"query","required":true,"schemaId":"schema_313"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["transactions:delete"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["transactions:delete"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/transactions","href":"transactions/deletetransaction","openApiOperationId":"deleteTransaction","summary":"Delete a transaction","securityGroups":[{"oauth2":["transactions:delete"]},{"bearerAuth":["transactions:delete"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully deleted","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_314","exampleIds":["paths/~1v1~1transactions/delete/responses/200/content/application~1json/example"]}},"schemaId":"schema_314","exampleIds":["paths/~1v1~1transactions/delete/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/delete/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/delete/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/delete/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/delete/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/delete/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/delete/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1transactions/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_314","exampleIds":["paths/~1v1~1transactions/delete/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_314","exampleIds":["paths/~1v1~1transactions/delete/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/delete/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1transactions/delete/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missing","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/invalid","paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/delete/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1transactions/delete/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/delete/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1transactions/delete/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/generic","paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transactions/deletetransaction"}],"panels":[]}]},"httpPath":"/v1/transactions"}],"content":{"contentType":"group","meta":{"name":"Transactions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Transactions","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/transactions","summary":"Get transactions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transactions/gettransactions","deprecated":false},{"title":"/v1/transactions","summary":"Create a transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/transactions/createtransaction","deprecated":false},{"title":"/v1/transactions","summary":"Update a transaction","prefix":{"name":"put","color":"put"},"badges":[],"link":"/transactions/updatetransaction","deprecated":false},{"title":"/v1/transactions","summary":"Delete a transaction","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/transactions/deletetransaction","deprecated":false}]}]}]}]}},{"type":"group","label":"User Availabilities","link":"/openapi/v1/openapi/user-availabilities","routeSlug":"/openapi/v1/openapi/user-availabilities","items":[{"label":"List user availabilities","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/user-availabilities/getuseravailabilities","routeSlug":"/openapi/v1/openapi/user-availabilities/getuseravailabilities","metadata":{"seo":{"title":"List user availabilities","description":"Returns availability schedules. Use userId to filter results for a specific user; omit it to return all accessible schedules. Each item includes schedule metadata, weekday slots, and linked event IDs."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getUserAvailabilities","name":"List user availabilities","isWebhook":false,"pointer":"/paths/~1v1~1userAvailabilities/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List user availabilities","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns availability schedules. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"userId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to filter results for a specific user; omit it to return all accessible schedules. Each item includes schedule metadata, weekday slots, and linked event IDs."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["availabilities:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["availabilities:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"userId","in":"query","schemaId":"schema_315","description":"Optional user ID to return availabilities for a specific user."}],"pointer":"/paths/~1v1~1userAvailabilities/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/userAvailabilities","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"userId","in":"query","schemaId":"schema_315"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["availabilities:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["availabilities:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/userAvailabilities","href":"user-availabilities/getuseravailabilities","openApiOperationId":"getUserAvailabilities","summary":"List user availabilities","securityGroups":[{"oauth2":["availabilities:read"]},{"bearerAuth":["availabilities:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Availability schedules matching the request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_316","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1userAvailabilities/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_316","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_316","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-availabilities/getuseravailabilities"}],"panels":[]}]},"httpPath":"/v1/userAvailabilities"}],"content":{"contentType":"group","meta":{"name":"User Availabilities"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"User Availabilities","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/userAvailabilities","summary":"List user availabilities","prefix":{"name":"get","color":"get"},"badges":[],"link":"/user-availabilities/getuseravailabilities","deprecated":false}]}]}]}]}},{"type":"group","label":"Users","link":"/openapi/v1/openapi/users","routeSlug":"/openapi/v1/openapi/users","items":[{"label":"List account users","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/v1/openapi/users/getusers","routeSlug":"/openapi/v1/openapi/users/getusers","metadata":{"seo":{"title":"List account users","description":"Returns users in the current account, including soft-deleted users. Supports pagination with limit (default 20, max 100) and page (zero-based, default 0). Optional filters: search (matches user name/email) and ids (comma-separated user IDs). Each user includes account role, connected integrations, and deletedAt when soft-deleted."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getUsers","name":"List account users","isWebhook":false,"pointer":"/paths/~1v1~1users/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List account users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns users in the current account, including soft-deleted users. Supports pagination with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (default 20, max 100) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (zero-based, default 0). Optional filters: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"search"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (matches user name/email) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (comma-separated user IDs). Each user includes account "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", connected integrations, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deletedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when soft-deleted."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oauth2","scopes":["users:read"],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}]},{"schemes":[{"name":"bearerAuth","scopes":["users:read"],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_317","description":"Number of users per page. Default is 20; maximum is 100."},{"name":"page","in":"query","schemaId":"schema_318","description":"Zero-based page index."},{"name":"search","in":"query","schemaId":"schema_319","description":"Optional text query that matches user name and email fields."},{"name":"ids","in":"query","schemaId":"schema_320","description":"Optional comma-separated user IDs to include in results."}],"pointer":"/paths/~1v1~1users/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/users","servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","schemaId":"schema_317"},{"name":"page","in":"query","schemaId":"schema_318"},{"name":"search","in":"query","schemaId":"schema_319"},{"name":"ids","in":"query","schemaId":"schema_320"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oauth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}],"scopes":["users:read"]},{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":["users:read"]}],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/v1/users","href":"users/getusers","openApiOperationId":"getUsers","summary":"List account users","securityGroups":[{"oauth2":["users:read"]},{"bearerAuth":["users:read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi/v1/openapi","description":"Mock server","isMockServer":true},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Users page plus total count matching the current filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321","exampleIds":["paths/~1v1~1users/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_321","exampleIds":["paths/~1v1~1users/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request or validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1users/get/responses/400/content/application~1json/examples/validationZodDetails"]}},"schemaId":"schema_184","exampleIds":["paths/~1v1~1users/get/responses/400/content/application~1json/examples/validationZodDetails"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized – missing or invalid API key (Bearer token required)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1users/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1users/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1users/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}},"schemaId":"schema_185","exampleIds":["paths/~1v1~1users/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1users/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1users/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden – insufficient permissions"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1users/get/responses/403/content/application~1json/example"]}},"schemaId":"schema_186","exampleIds":["paths/~1v1~1users/get/responses/403/content/application~1json/example"]},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND)"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1users/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/404/content/application~1json/examples/record"]}},"schemaId":"schema_187","exampleIds":["paths/~1v1~1users/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/404/content/application~1json/examples/record"]},{"code":"429","description":"Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1users/get/responses/429/content/application~1json/example"]}},"schemaId":"schema_188","exampleIds":["paths/~1v1~1users/get/responses/429/content/application~1json/example"],"headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window","schema":{"type":"string"}},"RateLimit-Reset":{"description":"ISO 8601 timestamp when the rate limit window resets","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the client can retry (when applicable)","schema":{"type":"string"}}},"headerSchemaId":"schema_189"},{"code":"500","description":"Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1users/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/500/content/application~1json/examples/withMessage"]}},"schemaId":"schema_190","exampleIds":["paths/~1v1~1users/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/500/content/application~1json/examples/withMessage"]}],"pointer":"/paths/~1v1~1users/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_321","exampleIds":["paths/~1v1~1users/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321","exampleIds":["paths/~1v1~1users/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_184","exampleIds":["paths/~1v1~1users/get/responses/400/content/application~1json/examples/validationZodDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184","exampleIds":["paths/~1v1~1users/get/responses/400/content/application~1json/examples/validationZodDetails"]}}},{"code":"401","schemaId":"schema_185","exampleIds":["paths/~1v1~1users/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1users/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1users/get/responses/401/content/application~1json/examples/missingFromRateLimiter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185","exampleIds":["paths/~1v1~1users/get/responses/401/content/application~1json/examples/missing","paths/~1v1~1users/get/responses/401/content/application~1json/examples/invalid","paths/~1v1~1users/get/responses/401/content/application~1json/examples/missingFromRateLimiter"]}}},{"code":"403","schemaId":"schema_186","exampleIds":["paths/~1v1~1users/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_186","exampleIds":["paths/~1v1~1users/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"schema_187","exampleIds":["paths/~1v1~1users/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/404/content/application~1json/examples/record"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_187","exampleIds":["paths/~1v1~1users/get/responses/404/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/404/content/application~1json/examples/record"]}}},{"code":"429","schemaId":"schema_188","exampleIds":["paths/~1v1~1users/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_188","exampleIds":["paths/~1v1~1users/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"schema_190","exampleIds":["paths/~1v1~1users/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/500/content/application~1json/examples/withMessage"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190","exampleIds":["paths/~1v1~1users/get/responses/500/content/application~1json/examples/generic","paths/~1v1~1users/get/responses/500/content/application~1json/examples/withMessage"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/users/getusers"}],"panels":[]}]},"httpPath":"/v1/users"}],"content":{"contentType":"group","meta":{"name":"Users"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Users","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/users","summary":"List account users","prefix":{"name":"get","color":"get"},"badges":[],"link":"/users/getusers","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"schema_173":{"kind":"json-schema","data":{"description":"Return only contacts assigned to this user ID.","type":"integer","minimum":1,"maximum":2147483647},"id":"schema_173"},"schema_174":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["POTENTIAL","QUALIFIED","DISQUALIFIED","STRATEGY_CALL_BOOKED","DISCOVERY_CALL_BOOKED"]},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated contact statuses to filter by. Allowed values: POTENTIAL, QUALIFIED, DISQUALIFIED, STRATEGY_CALL_BOOKED, DISCOVERY_CALL_BOOKED."},"children":[]}]}]}]},"id":"schema_174"},"schema_175":{"kind":"json-schema","data":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"description":"Comma-separated event IDs to filter by (positive integers only, for example 1,2,3)."},"id":"schema_175"},"schema_176":{"kind":"json-schema","data":{"description":"Case-insensitive single search value matched across firstName, lastName, email, and phoneNumber (not comma-separated values).","type":"string"},"id":"schema_176"},"schema_177":{"kind":"json-schema","data":{"default":20,"description":"Maximum contacts returned per page (1 to 100). Default is 20.","type":"integer","minimum":1,"maximum":100},"id":"schema_177"},"schema_178":{"kind":"json-schema","data":{"default":0,"description":"Zero-based page index for pagination. Default is 0.","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_178"},"schema_179":{"kind":"json-schema","data":{"description":"Lower bound for joinedTime filtering, in ISO 8601 date-time format.","type":"string","format":"date-time"},"id":"schema_179"},"schema_180":{"kind":"json-schema","data":{"description":"Upper bound for joinedTime filtering, in ISO 8601 date-time format. Use with timeFrom for ranges.","type":"string","format":"date-time"},"id":"schema_180"},"schema_181":{"kind":"json-schema","data":{"type":"string","enum":["asc","desc"]},"id":"schema_181"},"schema_182":{"kind":"json-schema","data":{"type":"string","enum":["id","createdAt","updatedAt","joinedTime","firstName","lastName","email"]},"id":"schema_182"},"schema_183":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"count":{"type":"number"},"contacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Unique contact ID."},"email":{"description":"Primary email address.","type":"string"},"firstName":{"description":"Contact first name.","type":"string"},"lastName":{"description":"Contact last name.","type":"string"},"status":{"description":"Current contact status.","type":"string"},"phoneNumber":{"description":"Primary phone number.","type":"string"},"previewId":{"description":"Public-safe preview identifier for the contact.","type":"string"},"country":{"description":"ISO country code or null when unset.","nullable":true,"type":"string"},"timeZone":{"description":"Time zone associated with the contact.","type":"string"},"blockedId":{"nullable":true,"description":"Related block record ID, or null when not blocked.","type":"number"},"leadScore":{"description":"Lead score associated with the contact.","type":"number"},"createdAt":{"description":"Creation timestamp.","type":"string"},"secondary_email":{"description":"Secondary email when set.","nullable":true,"type":"string","format":"email"},"secondary_phoneNumber":{"description":"Secondary phone number when set.","nullable":true,"type":"string"},"ContactEvents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Event ID associated with the contact."},"name":{"type":"string","description":"Event name associated with the contact."}},"required":["id","name"],"additionalProperties":false}},"user":{"type":"object","properties":{"id":{"type":"number","description":"User ID of the assigned contact owner."},"firstName":{"type":"string","description":"Assigned user first name."},"lastName":{"type":"string","description":"Assigned user last name."},"email":{"type":"string","description":"Assigned user email address."}},"required":["id","firstName","lastName","email"],"additionalProperties":false}},"required":["id","blockedId"],"additionalProperties":false}}},"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_183"},"schema_184":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable summary (first field/form error for Zod validation failures)."},"details":{"description":"Present when the failure is from createZodBodyValidator / createZodQueryValidator.","type":"object","properties":{"formErrors":{"type":"array","items":{"type":"string"},"description":"Global form-level error messages"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Field name to list of validation error messages"}},"required":["formErrors","fieldErrors"],"additionalProperties":false},"stack":{"description":"Present only in non-production environments.","type":"string"}},"required":["message"],"additionalProperties":false},"id":"schema_184"},"schema_185":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"e.g. \"API key is required\" or \"Invalid API key\""},"code":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional code e.g. MISSING_API_KEY when rate limiter runs before valid auth"},"children":[]}]}]}],"type":"string"}},"required":["message"],"additionalProperties":false},"id":"schema_185"},"schema_186":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false},"id":"schema_186"},"schema_187":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"e.g. \"Resource not found!\" or \"Record not found!\""}},"required":["message"],"additionalProperties":false},"id":"schema_187"},"schema_188":{"kind":"json-schema","data":{"type":"object","properties":{"code":{"type":"string","enum":["RATE_LIMIT_EXCEEDED"],"description":"Fixed code for rate limit responses"},"message":{"type":"string","description":"e.g. \"Too many requests, please try again later.\""},"retryAfter":{"description":"Seconds until the rate limit window resets","type":"number"},"limit":{"description":"Configured limit (when using account-based rate limiter)","type":"object","properties":{"points":{"type":"number"},"windowSec":{"type":"number"}},"required":["points","windowSec"],"additionalProperties":false}},"required":["code","message"],"additionalProperties":false},"id":"schema_188"},"schema_189":{"kind":"json-schema","data":{"type":"object","properties":{"RateLimit-Limit":{"type":"string","description":"Maximum requests allowed in the current window"},"RateLimit-Remaining":{"type":"string","description":"Requests remaining in the current window"},"RateLimit-Reset":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the rate limit window resets"},"Retry-After":{"type":"string","description":"Seconds until the client can retry (when applicable)"}}},"id":"schema_189"},"schema_190":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Generic: \"Something went wrong\" for Prisma errors, or error message"},"stack":{"description":"Present only in non-production","type":"string"}},"required":["message"],"additionalProperties":false},"id":"schema_190"},"schema_191":{"kind":"json-schema","data":{"type":"object","properties":{"firstName":{"type":"string","maxLength":25},"lastName":{"type":"string","maxLength":25},"email":{"type":"string","maxLength":255,"format":"email"},"phoneNumber":{"type":"string","maxLength":16,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"International (E.164) phone: optional + and up to 15 digits."},"children":[]}]}]}]},"status":{"type":"string","enum":["POTENTIAL","QUALIFIED","DISQUALIFIED"]},"tag":{"type":"string","maxLength":100},"joinedTime":{"description":"Date and time when the contact joined, in ISO 8601 format (for example, 2024-01-15T10:00:00.000Z).","type":"string","format":"date-time"},"linkPrefix":{"type":"string","maxLength":255},"utm":{"type":"string","maxLength":1000},"country":{"description":"Two-letter ISO 3166-1 alpha-2 country code (for example, US or GB).","type":"string","maxLength":2},"timeZone":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IANA time zone identifier (for example, America/New_York, Asia/Karachi, or Etc/UTC)."},"children":[]}]}]}],"type":"string","maxLength":50},"ipAddress":{"type":"string","maxLength":45},"referrerUrl":{"type":"string","maxLength":500,"format":"uri"}},"additionalProperties":false},"id":"schema_191"},"schema_192":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"contact":{"nullable":true,"description":"Created or updated contact payload, or null when unavailable.","type":"object","properties":{"id":{"type":"number","description":"Unique contact ID."},"accountId":{"type":"number","description":"Owning account ID for the contact."},"userId":{"nullable":true,"description":"Assigned user ID, or null when unassigned.","type":"number"},"email":{"description":"Primary email address.","type":"string"},"firstName":{"description":"Contact first name.","type":"string"},"lastName":{"description":"Contact last name.","type":"string"},"status":{"description":"Current contact status.","type":"string"},"phoneNumber":{"description":"Primary phone number.","type":"string"},"previewId":{"description":"Public-safe preview identifier for the contact.","type":"string"},"tagId":{"description":"Associated tag ID when a tag is assigned.","type":"number"},"blockedByRecaptcha":{"description":"Whether the contact was flagged by reCAPTCHA checks.","type":"boolean"},"joinedTime":{"description":"Date and time when the contact joined.","type":"string"},"country":{"description":"Country code associated with the contact.","type":"string"},"timeZone":{"description":"Time zone associated with the contact.","type":"string"},"blockedId":{"nullable":true,"description":"Related block record ID, or null when not blocked.","type":"number"},"referrerUrl":{"description":"Referrer URL where the contact originated.","type":"string"},"leadScore":{"description":"Lead score associated with the contact.","type":"number"},"createdAt":{"description":"Creation timestamp.","type":"string"},"updatedAt":{"description":"Last update timestamp.","type":"string"},"deletedAt":{"nullable":true,"description":"Soft-delete timestamp, or null when active.","type":"string"}},"required":["id","accountId","userId","blockedId","deletedAt"],"additionalProperties":false}},"required":["contact"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_192"},"schema_193":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"message":{"type":"string"},"contact":{"type":"object","properties":{"id":{"type":"number","description":"Unique contact ID."},"accountId":{"type":"number","description":"Owning account ID for the contact."},"userId":{"nullable":true,"description":"Assigned user ID, or null when unassigned.","type":"number"},"email":{"description":"Primary email address.","type":"string"},"firstName":{"description":"Contact first name.","type":"string"},"lastName":{"description":"Contact last name.","type":"string"},"status":{"description":"Current contact status.","type":"string"},"phoneNumber":{"description":"Primary phone number.","type":"string"},"previewId":{"description":"Public-safe preview identifier for the contact.","type":"string"},"tagId":{"description":"Associated tag ID when a tag is assigned.","type":"number"},"blockedByRecaptcha":{"description":"Whether the contact was flagged by reCAPTCHA checks.","type":"boolean"},"joinedTime":{"description":"Date and time when the contact joined.","type":"string"},"country":{"description":"Country code associated with the contact.","type":"string"},"timeZone":{"description":"Time zone associated with the contact.","type":"string"},"blockedId":{"nullable":true,"description":"Related block record ID, or null when not blocked.","type":"number"},"referrerUrl":{"description":"Referrer URL where the contact originated.","type":"string"},"leadScore":{"description":"Lead score associated with the contact.","type":"number"},"createdAt":{"description":"Creation timestamp.","type":"string"},"updatedAt":{"description":"Last update timestamp.","type":"string"},"deletedAt":{"nullable":true,"description":"Soft-delete timestamp, or null when active.","type":"string"}},"required":["id","accountId","userId","blockedId","deletedAt"],"additionalProperties":false}},"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_193"},"schema_194":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Contact ID to update."},"firstName":{"description":"Updated first name (max 25 chars).","type":"string","maxLength":25},"lastName":{"description":"Updated last name (max 25 chars).","type":"string","maxLength":25},"email":{"description":"Updated primary email address.","type":"string","maxLength":255,"format":"email"},"secondary_email":{"description":"Updated secondary email address.","type":"string","maxLength":255,"format":"email"},"phoneNumber":{"type":"string","maxLength":16,"description":"Updated primary phone number in E.164 format."},"secondary_phoneNumber":{"type":"string","maxLength":16,"description":"Updated secondary phone number in E.164 format."},"status":{"description":"Updated contact status.","type":"string","enum":["POTENTIAL","QUALIFIED","DISQUALIFIED"]},"referrerUrl":{"description":"Updated referrer URL.","type":"string","maxLength":500,"format":"uri"}},"required":["id"],"additionalProperties":false},"id":"schema_194"},"schema_195":{"kind":"json-schema","data":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Contact ID to fetch details for."},"id":"schema_195"},"schema_196":{"kind":"json-schema","data":{"default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true, include UTMs in a flat "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"utms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array (with eventCallId per row)."},"children":[]}]}]}],"type":"boolean"},"id":"schema_196"},"schema_197":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number","description":"Unique contact ID."},"firstName":{"type":"string","description":"Contact first name."},"lastName":{"type":"string","description":"Contact last name."},"email":{"type":"string","description":"Primary contact email address."},"phoneNumber":{"description":"Primary contact phone number.","type":"string"},"secondary_email":{"nullable":true,"description":"Secondary email address, or null when not set.","type":"string"},"secondary_phoneNumber":{"nullable":true,"description":"Secondary phone number, or null when not set.","type":"string"},"status":{"type":"string","description":"Current contact status."},"joinedTime":{"type":"string","description":"Joined timestamp as an ISO 8601 string."},"createdAt":{"type":"string","description":"Creation timestamp as an ISO 8601 string."},"updatedAt":{"type":"string","description":"Last update timestamp as an ISO 8601 string."},"referrerUrl":{"description":"Referrer URL where the contact originated, when available.","type":"string"},"previewId":{"description":"Public-safe preview identifier for the contact.","type":"string"},"timeZone":{"description":"Contact time zone, when available.","type":"string"},"user":{"description":"Assigned user summary for the contact.","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"User ID of the assigned contact owner."},"firstName":{"type":"string","description":"Assigned user first name."},"lastName":{"type":"string","description":"Assigned user last name."},"email":{"type":"string","description":"Assigned user email address."}},"required":["id","firstName","lastName","email"],"additionalProperties":false},"ContactEvents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Event ID associated with the contact."},"name":{"type":"string","description":"Event name associated with the contact."},"location":{"type":"string","description":"Event location type or location label."},"color":{"type":"string","description":"Event color value used for display."}},"required":["id","name","location","color"],"additionalProperties":false},"description":"Events associated with the contact."},"ContactStats":{"nullable":true,"description":"Aggregated contact statistics, or null when unavailable.","type":"object","properties":{"initialStatus":{"type":"string","enum":["POTENTIAL","QUALIFIED","DISQUALIFIED","STRATEGY_CALL_BOOKED","DISCOVERY_CALL_BOOKED"],"description":"First recorded contact status."},"statusUpdatedAt":{"type":"string","description":"Timestamp of the latest status update."},"lastInteractionStatus":{"type":"string","description":"Status associated with the latest interaction."},"lastInteractionType":{"type":"string","description":"Type of the latest interaction."},"totalCallsBooked":{"type":"number","description":"Total number of booked calls."},"strategyCallsBooked":{"type":"number","description":"Number of booked strategy calls."},"discoveryCallsBooked":{"type":"number","description":"Number of booked discovery calls."},"income":{"type":"number","description":"Income amount attributed to the contact."}},"required":["initialStatus","statusUpdatedAt","lastInteractionStatus","lastInteractionType","totalCallsBooked","strategyCallsBooked","discoveryCallsBooked","income"],"additionalProperties":false},"pastCallsCount":{"type":"number","description":"Number of past calls linked to this contact."},"upcomingCallsCount":{"type":"number","description":"Number of upcoming calls linked to this contact."},"utms":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Flat UTM list. Present when includeUtms=true. Each row contains eventCallId (nullable), utmKey, and utmValue."},"children":[]}]}]}],"type":"array","items":{"type":"object","properties":{"eventCallId":{"nullable":true,"description":"Related event call ID, or null when not linked to a call.","type":"number"},"utmKey":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"UTM parameter key (for example, utm_source)."},"children":[]}]}]}]},"utmValue":{"type":"string","description":"UTM parameter value."}},"required":["eventCallId","utmKey","utmValue"],"additionalProperties":false}},"CustomFieldAssociation":{"type":"array","items":{"type":"object","properties":{"customField":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"type":"string","description":"Custom field display name."},"type":{"type":"string","description":"Custom field object type/category."},"inputType":{"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","CONTACT","CONTACTS_MULTIPLE","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"],"description":"Configured input type for this custom field."},"identifier":{"type":"string","description":"Stable custom field identifier key."}},"required":["id","name","type","inputType","identifier"],"additionalProperties":false},"CustomFieldAnswer":{"type":"array","items":{"type":"object","properties":{"inputType":{"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","CONTACT","CONTACTS_MULTIPLE","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"],"description":"Input type that determines which answer value field is used."},"answer":{"nullable":true,"description":"String answer payload when applicable to the input type.","type":"string"},"date":{"nullable":true,"description":"Date answer payload when applicable to the input type.","type":"string"},"number":{"nullable":true,"description":"Numeric answer payload when applicable to the input type.","type":"number"},"customFieldOptionId":{"nullable":true,"description":"Selected custom-field option ID for select-like input types.","type":"number"},"user":{"description":"Referenced user for USER-type answers.","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"User ID of the assigned contact owner."},"firstName":{"type":"string","description":"Assigned user first name."},"lastName":{"type":"string","description":"Assigned user last name."}},"required":["id","firstName","lastName"],"additionalProperties":false}},"required":["inputType","answer","date","number","customFieldOptionId"],"additionalProperties":false},"description":"Answer rows stored for this custom field on the contact."}},"required":["customField","CustomFieldAnswer"],"additionalProperties":false},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Answered custom fields for this contact only. Unanswered fields are not returned. For MULTIPLE_SELECT and similar types, a field can contain multiple answers (for example, different customFieldOptionId values). To render all available fields, fetch CONTACT custom-field definitions and merge by custom field id or identifier."},"children":[]}]}]}]}},"required":["id","firstName","lastName","email","secondary_email","secondary_phoneNumber","status","joinedTime","createdAt","updatedAt","ContactEvents","pastCallsCount","upcomingCallsCount","CustomFieldAssociation"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_197"},"schema_198":{"kind":"json-schema","data":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Contact ID whose notes should be returned."},"id":"schema_198"},"schema_199":{"kind":"json-schema","data":{"default":20,"description":"Maximum notes returned per page. Default is 20.","type":"integer","minimum":1,"maximum":100},"id":"schema_199"},"schema_200":{"kind":"json-schema","data":{"type":"object","properties":{"count":{"type":"number","description":"Total number of notes available for the contact."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Note ID."},"text":{"description":"Note text content.","nullable":true,"type":"string"},"createdAt":{"description":"Note creation timestamp.","anyOf":[{"type":"string"},{"type":"string","format":"date-time"}]},"updatedAt":{"description":"Note last update timestamp.","anyOf":[{"type":"string"},{"type":"string","format":"date-time"}]},"type":{"description":"Note type/category when provided by the backend.","nullable":true,"type":"string"},"user":{"description":"Author summary for the note.","nullable":true,"type":"object","properties":{"firstName":{"description":"Author first name.","nullable":true,"type":"string"},"lastName":{"description":"Author last name.","nullable":true,"type":"string"}},"additionalProperties":false}},"required":["id"],"additionalProperties":false},"description":"Paginated list of note records for the requested page."}},"required":["count","data"],"additionalProperties":false},"id":"schema_200"},"schema_201":{"kind":"json-schema","data":{"type":"object","properties":{"contactId":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Contact ID. The contact to attach the note to."},"note":{"type":"string","minLength":1,"maxLength":10000,"description":"Note body content. Supports plain text or HTML."}},"required":["contactId","note"],"additionalProperties":false},"id":"schema_201"},"schema_202":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Human-readable result message from the server.","type":"string"},"status":{"description":"Numeric HTTP status code (for example, 201).","type":"number"}},"additionalProperties":false},"id":"schema_202"},"schema_203":{"kind":"json-schema","data":{"description":"Filter deals linked to this contact id.","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_203"},"schema_204":{"kind":"json-schema","data":{"description":"Comma-separated user ids; resolved to account user ids for filtering deals by assignee.","type":"string"},"id":"schema_204"},"schema_205":{"kind":"json-schema","data":{"description":"Comma-separated product ids; filters deals by productId in that set.","type":"string"},"id":"schema_205"},"schema_206":{"kind":"json-schema","data":{"type":"string","enum":["WON","RECURRING","DEPOSIT"]},"id":"schema_206"},"schema_207":{"kind":"json-schema","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated contact status values (POTENTIAL, QUALIFIED, DISQUALIFIED, STRATEGY_CALL_BOOKED, DISCOVERY_CALL_BOOKED); filters deals whose contact status is in the list."},"children":[]}]}]}],"type":"string"},"id":"schema_207"},"schema_208":{"kind":"json-schema","data":{"nullable":true,"description":"Comma-separated event ids; filters deals with an eventCall tied to one of those events.","type":"string"},"id":"schema_208"},"schema_209":{"kind":"json-schema","data":{"description":"Case-insensitive search across provider, product name, and contact fields.","type":"string"},"id":"schema_209"},"schema_210":{"kind":"json-schema","data":{"default":20,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum deals per page (1–200). Default 20."},"children":[]}]}]}],"type":"integer","minimum":1,"maximum":200},"id":"schema_210"},"schema_211":{"kind":"json-schema","data":{"default":0,"description":"Zero-based page index for pagination.","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_211"},"schema_212":{"kind":"json-schema","data":{"type":"string","enum":["id","time","value","firstName","lastName","email","phoneNumber"]},"id":"schema_212"},"schema_213":{"kind":"json-schema","data":{"description":"Inclusive lower bound for deal time (ISO date, e.g. 2026-03-31T00:00:00.000Z).","type":"string"},"id":"schema_213"},"schema_214":{"kind":"json-schema","data":{"description":"Inclusive upper bound for deal time (ISO date, e.g. 2026-03-31T23:59:59.999Z).","type":"string"},"id":"schema_214"},"schema_215":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"count":{"type":"number","description":"Total deals matching the query (for pagination)."},"deals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Deal id."},"productId":{"nullable":true,"description":"Linked product id.","type":"number"},"contactId":{"nullable":true,"description":"Linked contact id.","type":"number"},"eventCallId":{"nullable":true,"description":"Linked event call / booking id.","type":"number"},"userId":{"nullable":true,"description":"Assignee user id.","type":"number"},"value":{"description":"Deal monetary value (number or string encoding).","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"time":{"nullable":true,"description":"Deal time in account time zone (formatted string).","type":"string"},"recurring":{"nullable":true,"description":"Whether the deal is recurring.","type":"boolean"},"transactionType":{"nullable":true,"description":"Transaction type label on the deal.","type":"string","enum":["WON","RECURRING","DEPOSIT"]},"createdAt":{"nullable":true,"description":"Deal created at (formatted string).","type":"string"},"updatedAt":{"nullable":true,"description":"Deal updated at (formatted string).","type":"string"},"user":{"nullable":true,"description":"Assigned user summary.","type":"object","properties":{"id":{"type":"number","description":"User id."},"firstName":{"nullable":true,"description":"User first name.","type":"string"},"lastName":{"nullable":true,"description":"User last name.","type":"string"},"email":{"nullable":true,"description":"User email.","type":"string","format":"email"}},"required":["id"],"additionalProperties":false},"event":{"nullable":true,"description":"Related event summary when available.","type":"object","properties":{"name":{"nullable":true,"description":"Event display name.","type":"string"},"color":{"nullable":true,"description":"Event color (e.g. hex).","type":"string"},"eventType":{"nullable":true,"description":"Event type discriminator.","type":"string"}},"additionalProperties":false},"contact":{"nullable":true,"description":"Related contact when loaded.","type":"object","properties":{"id":{"type":"number","description":"Contact id."},"userId":{"nullable":true,"description":"Owning user id when set.","type":"number"},"firstName":{"nullable":true,"description":"Contact first name.","type":"string"},"lastName":{"nullable":true,"description":"Contact last name.","type":"string"},"email":{"nullable":true,"description":"Primary email.","type":"string","format":"email"},"phoneNumber":{"nullable":true,"description":"Primary phone number.","type":"string"},"secondary_email":{"nullable":true,"description":"Secondary email.","type":"string","format":"email"},"secondary_phoneNumber":{"nullable":true,"description":"Secondary phone number.","type":"string"},"country":{"nullable":true,"description":"Country code or label.","type":"string"},"timeZone":{"nullable":true,"description":"IANA or stored time zone string.","type":"string"},"ipAddress":{"nullable":true,"description":"Last known IP address.","type":"string"},"status":{"nullable":true,"description":"Contact pipeline/status value.","type":"string"},"blockedByRecaptcha":{"nullable":true,"description":"Whether contact is blocked by reCAPTCHA.","type":"boolean"},"joinedTime":{"nullable":true,"description":"First join time (formatted string).","type":"string"},"referrerUrl":{"nullable":true,"description":"Referrer URL when captured.","type":"string"},"previewId":{"nullable":true,"description":"Preview / widget identifier.","type":"string"},"createdVia":{"nullable":true,"description":"Source channel (e.g. scheduling widget).","type":"string"},"createdAt":{"nullable":true,"description":"Contact created at (formatted string).","type":"string"},"updatedAt":{"nullable":true,"description":"Contact updated at (formatted string).","type":"string"}},"required":["id"],"additionalProperties":false},"tag":{"nullable":true,"description":"Tag on the deal when present.","type":"object","properties":{"id":{"type":"number","description":"Tag id."},"name":{"nullable":true,"description":"Tag name.","type":"string"},"value":{"description":"Tag value (numeric or string).","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"createdAt":{"nullable":true,"description":"Tag created at.","type":"string"},"updatedAt":{"nullable":true,"description":"Tag updated at.","type":"string"}},"required":["id"],"additionalProperties":false},"product":{"nullable":true,"description":"Product summary when loaded.","type":"object","properties":{"id":{"type":"number","description":"Product id."},"name":{"nullable":true,"description":"Product name.","type":"string"},"createdAt":{"nullable":true,"description":"Product created at (formatted string).","type":"string"}},"required":["id"],"additionalProperties":false}},"required":["id"],"additionalProperties":false},"description":"Deal rows for the current page."}},"required":["count","deals"],"additionalProperties":false,"description":"Paginated list payload: count and deals array."}},"required":["data"],"additionalProperties":false},"id":"schema_215"},"schema_216":{"kind":"json-schema","data":{"type":"object","properties":{"eventCallId":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Event call / booking this deal is created from."},"productId":{"description":"Existing product id (validated for the account).","type":"integer","minimum":0,"maximum":2147483647},"productName":{"description":"Product name when creating without productId (at least one of productId or productName required).","type":"string"},"value":{"description":"Deal value amount.","type":"number"},"time":{"description":"Deal time as ISO 8601 datetime; must be in the future when provided.","type":"string","format":"date-time"},"transactionType":{"description":"Initial transaction type when set.","type":"string","enum":["WON","RECURRING","DEPOSIT"]},"transactionIds":{"description":"Existing transaction ids to associate with the new deal.","type":"array","items":{"type":"integer","minimum":0,"maximum":2147483647}}},"required":["eventCallId"],"additionalProperties":false,"example":{"eventCallId":5,"productId":1,"value":100,"time":"2026-06-15T15:00:00.000Z","transactionType":"WON"}},"id":"schema_216"},"schema_217":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number","description":"Deal id."},"productId":{"nullable":true,"description":"Linked product id.","type":"number"},"contactId":{"nullable":true,"description":"Linked contact id.","type":"number"},"eventCallId":{"nullable":true,"description":"Linked event call id.","type":"number"},"userId":{"nullable":true,"description":"Assignee user id.","type":"number"},"tagId":{"nullable":true,"description":"Tag id on the deal when set.","type":"number"},"value":{"description":"Deal value (number or string).","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"time":{"nullable":true,"description":"Deal time (ISO or formatted string).","type":"string"},"recurring":{"nullable":true,"description":"Whether the deal is recurring.","type":"boolean"},"transactionType":{"nullable":true,"description":"Transaction type label.","type":"string","enum":["WON","RECURRING","DEPOSIT"]},"createdAt":{"nullable":true,"description":"Created at.","type":"string"},"updatedAt":{"nullable":true,"description":"Updated at.","type":"string"},"product":{"nullable":true,"description":"Minimal product info (name).","type":"object","properties":{"name":{"nullable":true,"description":"Product display name on the deal response.","type":"string"}},"additionalProperties":false},"eventCall":{"nullable":true,"description":"Booking / call context with nested user, contact, event.","type":"object","properties":{"id":{"type":"number","description":"Event call / booking id."},"userId":{"nullable":true,"description":"Host or assigned user id.","type":"number"},"eventId":{"nullable":true,"description":"Template event id.","type":"number"},"previewId":{"nullable":true,"description":"Preview or widget session id.","type":"string"},"callType":{"nullable":true,"description":"Kind of call or meeting.","type":"string"},"dateTime":{"nullable":true,"description":"Scheduled start as ISO or formatted string.","type":"string"},"user":{"nullable":true,"description":"User on the call.","type":"object","properties":{"id":{"type":"number","description":"User id."},"firstName":{"nullable":true,"description":"First name.","type":"string"},"lastName":{"nullable":true,"description":"Last name.","type":"string"},"email":{"nullable":true,"description":"Email.","type":"string","format":"email"},"phoneNumber":{"nullable":true,"description":"Phone number.","type":"string"}},"required":["id"],"additionalProperties":false},"contact":{"nullable":true,"description":"Contact on the call.","type":"object","properties":{"id":{"type":"number","description":"Contact id."},"firstName":{"nullable":true,"description":"First name.","type":"string"},"lastName":{"nullable":true,"description":"Last name.","type":"string"},"email":{"nullable":true,"description":"Email.","type":"string","format":"email"},"phoneNumber":{"nullable":true,"description":"Phone number.","type":"string"}},"required":["id"],"additionalProperties":false},"event":{"nullable":true,"description":"Event definition for the call.","type":"object","properties":{"id":{"type":"number","description":"Event id."},"eventType":{"nullable":true,"description":"Event type discriminator.","type":"string"},"name":{"nullable":true,"description":"Event display name.","type":"string"},"color":{"nullable":true,"description":"Event color.","type":"string"},"duration":{"nullable":true,"description":"Scheduled duration magnitude.","type":"number"},"durationUnit":{"nullable":true,"description":"Unit for duration (e.g. minutes).","type":"string"}},"required":["id"],"additionalProperties":false}},"required":["id"],"additionalProperties":false},"transaction":{"nullable":true,"description":"Transactions associated with this deal.","type":"array","items":{"type":"object","properties":{"id":{"nullable":true,"description":"Transaction id.","type":"number"},"accountId":{"nullable":true,"description":"Owning account id.","type":"number"},"syncedDeal":{"nullable":true,"description":"Linked deal id when synced.","type":"number"},"name":{"nullable":true,"description":"Counterparty or transaction name.","type":"string"},"email":{"nullable":true,"description":"Email on the transaction.","type":"string","format":"email"},"phoneNumber":{"nullable":true,"description":"Phone on the transaction.","type":"string"},"description":{"nullable":true,"description":"Free-text description.","type":"string"},"value":{"description":"Transaction amount (number or string).","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"currency":{"nullable":true,"description":"Currency code or label.","type":"string"},"source":{"nullable":true,"description":"Origin system or channel.","type":"string"},"updatedBy":{"nullable":true,"description":"Actor or label for last update.","type":"string"},"createdAt":{"nullable":true,"description":"Created at (ISO or formatted string).","type":"string"},"updatedAt":{"nullable":true,"description":"Updated at (ISO or formatted string).","type":"string"},"deletedAt":{"nullable":true,"description":"Soft-delete timestamp when set.","type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false,"description":"Single deal after create or update, with nested product, eventCall, and transactions."}},"required":["data"],"additionalProperties":false},"id":"schema_217"},"schema_218":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Deal id to update."},"value":{"description":"Updated deal value.","type":"number"},"recurring":{"description":"Whether the deal is recurring.","type":"boolean"},"transactionType":{"description":"Updated transaction type.","type":"string","enum":["WON","RECURRING","DEPOSIT"]},"productId":{"description":"Reassign deal to another product.","type":"integer","minimum":0,"maximum":2147483647},"closerId":{"description":"User id of the closer (assignee).","type":"integer","minimum":0,"maximum":2147483647},"time":{"description":"Updated deal time as ISO 8601 datetime; must be in the future when provided.","type":"string","format":"date-time"},"transactionIds":{"description":"Transaction ids to link or sync with this deal.","type":"array","items":{"type":"integer","minimum":0,"maximum":2147483647}},"type":{"description":"Deal vs transaction classification.","type":"string","enum":["DEAL","TRANSACTION"]},"email":{"description":"Email context for the update when required by the service.","type":"string","format":"email"}},"required":["id"],"additionalProperties":false,"example":{"id":1,"value":150,"recurring":false,"transactionType":"WON"}},"id":"schema_218"},"schema_219":{"kind":"json-schema","data":{"default":10,"description":"Maximum number of events returned per page","type":"integer","minimum":1,"maximum":500},"id":"schema_219"},"schema_220":{"kind":"json-schema","data":{"description":"Zero-based page index","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_220"},"schema_221":{"kind":"json-schema","data":{"description":"Free-text search on event name, description, internal description, link prefix, and vanity paths (e.g. eve-2 or e/dev/eve-2)","type":"string"},"id":"schema_221"},"schema_222":{"kind":"json-schema","data":{"description":"Filter by owner/host user ID","type":"integer","exclusiveMinimum":true,"maximum":2147483647,"minimum":0},"id":"schema_222"},"schema_223":{"kind":"json-schema","data":{"type":"string","enum":["STRATEGY_EVENT","DISCOVERY_EVENT"]},"id":"schema_223"},"schema_224":{"kind":"json-schema","data":{"description":"When true, events are ordered by createdAt (direction from sort when provided, else newest first)","type":"string"},"id":"schema_224"},"schema_225":{"kind":"json-schema","data":{"type":"string","enum":["true","false"]},"id":"schema_225"},"schema_226":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"description":"Event list payload","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Event ID"},"name":{"description":"Event display name","nullable":true,"type":"string"},"color":{"description":"Event color","nullable":true,"type":"string"},"eventType":{"description":"Event type","nullable":true,"type":"string","enum":["STRATEGY_EVENT","DISCOVERY_EVENT"]},"description":{"description":"Public event description","nullable":true,"type":"string"},"internalDescription":{"description":"Internal-only event description","nullable":true,"type":"string"},"deletedAt":{"description":"Soft-delete timestamp","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"language":{"description":"Language code used by the event","nullable":true,"type":"string"},"emailValidationEnabled":{"description":"Whether invitee email validation is enabled","nullable":true,"type":"boolean"},"phoneNumberValidationEnabled":{"description":"Whether invitee phone validation is enabled","nullable":true,"type":"boolean"},"creditCheck":{"description":"Credit-check settings for the event","nullable":true,"type":"object","properties":{"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit-check discriminator or provider type (for example CREDIT_CHECK_DTI_RATIO)."},"children":[]}]}]}],"nullable":true,"type":"string"},"toggle":{"description":"Whether credit check is enabled for this event","type":"boolean"}},"additionalProperties":false},"userId":{"description":"Primary owner user ID","nullable":true,"type":"number"},"duration":{"description":"Event duration value","nullable":true,"type":"number"},"durationUnit":{"description":"Duration unit (typically MINUTES)","nullable":true,"type":"string"},"location":{"description":"Event location type/provider","nullable":true,"type":"string","enum":["PHONE_CALL","ZOOM","GOOGLE_MEET","STATIC_LINK","MICROSOFT_TEAMS","HOST_PERSONAL_LINK"]},"dateRangeType":{"description":"Date-range strategy","nullable":true,"type":"string"},"dateRangeUnit":{"description":"Date-range unit","nullable":true,"type":"string"},"linkPrefix":{"description":"Public booking link prefix","nullable":true,"type":"string"},"status":{"description":"Activation status of the event","nullable":true,"type":"string","enum":["ACTIVATED","DEACTIVATED"]},"allowReschedule":{"description":"Whether invitees can reschedule","nullable":true,"type":"boolean"},"phonePreferred":{"description":"Whether phone input is preferred","nullable":true,"type":"boolean"},"splitFullName":{"description":"Whether first/last names are collected separately","nullable":true,"type":"boolean"},"businessEmail":{"description":"Whether business email is required/enforced","nullable":true,"type":"boolean"},"disableDuplicateBooking":{"description":"Whether duplicate bookings are blocked","nullable":true,"type":"boolean"},"lockHostOnReschedule":{"description":"Whether host remains fixed on reschedule","nullable":true,"type":"boolean"},"dateRangeDays":{"description":"Number of days included in booking range","nullable":true,"type":"number"},"bypassQuestion":{"description":"Whether invitee questions are bypassed","nullable":true,"type":"boolean"},"isConditionalRoutingDisabled":{"description":"When true, conditional routing rules are ignored and EventLogicGroup is returned empty","nullable":true,"type":"boolean"},"internalGuestEmails":{"description":"Emails included on every booking from this event","nullable":true,"type":"array","items":{"type":"string"}},"allowInviteeAdditionalGuests":{"description":"Whether invitees may add extra guest emails when booking","nullable":true,"type":"boolean"},"featureStatuses":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Feature tooltip summaries; present when showFeatureStatuses=true"},"children":[]}]}]}],"type":"object","properties":{"disqualification":{"nullable":true,"type":"object","properties":{"enabled":{"type":"boolean"},"rules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"action":{"type":"string"}},"required":["condition","action"],"additionalProperties":false}}},"required":["enabled","rules"],"additionalProperties":false},"conditionalRouting":{"nullable":true,"type":"object","properties":{"enabled":{"type":"boolean"},"rules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"routeTo":{"type":"string"}},"required":["condition","routeTo"],"additionalProperties":false}}},"required":["enabled","rules"],"additionalProperties":false},"dataIntelligence":{"nullable":true,"type":"object","properties":{"enabled":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"enabled":{"type":"boolean"}},"required":["label","enabled"],"additionalProperties":false}}},"required":["enabled","items"],"additionalProperties":false}},"required":["disqualification","conditionalRouting","dataIntelligence"],"additionalProperties":false}},"required":["id"],"additionalProperties":false}},"count":{"description":"Count of items returned in current payload","type":"number"},"totalCount":{"description":"Total count matching applied filters","type":"number"},"hasVisibleEvents":{"description":"Whether account has any events visible to the caller","type":"boolean"}},"additionalProperties":false},"id":"schema_226"},"schema_227":{"kind":"json-schema","data":{"description":"Event ID","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_227"},"schema_228":{"kind":"json-schema","data":{"description":"Event link prefix","type":"string"},"id":"schema_228"},"schema_229":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"description":"Single event payload","type":"object","properties":{"id":{"type":"number","description":"Event ID"},"name":{"description":"Event name","nullable":true,"type":"string"},"color":{"description":"Event color","nullable":true,"type":"string"},"eventType":{"description":"Event type","nullable":true,"type":"string","enum":["STRATEGY_EVENT","DISCOVERY_EVENT"]},"description":{"description":"Public event description","nullable":true,"type":"string"},"internalDescription":{"description":"Internal-only event description","nullable":true,"type":"string"},"deletedAt":{"description":"Soft-delete timestamp","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"language":{"description":"Language code used by the event","nullable":true,"type":"string"},"emailValidationEnabled":{"description":"Whether invitee email validation is enabled","nullable":true,"type":"boolean"},"phoneNumberValidationEnabled":{"description":"Whether invitee phone validation is enabled","nullable":true,"type":"boolean"},"creditCheck":{"description":"Credit-check settings for the event","nullable":true,"type":"object","properties":{"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit-check discriminator or provider type (for example CREDIT_CHECK_DTI_RATIO)."},"children":[]}]}]}],"nullable":true,"type":"string"},"toggle":{"description":"Whether credit check is enabled for this event","type":"boolean"}},"additionalProperties":false},"userId":{"description":"Primary owner/host user ID","type":"number"},"duration":{"description":"Event duration value","nullable":true,"type":"number"},"durationUnit":{"description":"Duration unit (typically MINUTES)","nullable":true,"type":"string"},"location":{"description":"Event location type/provider","nullable":true,"type":"string","enum":["PHONE_CALL","ZOOM","GOOGLE_MEET","STATIC_LINK","MICROSOFT_TEAMS","HOST_PERSONAL_LINK"]},"dateRangeType":{"description":"Date-range strategy","nullable":true,"type":"string"},"dateRangeUnit":{"description":"Date-range unit","nullable":true,"type":"string"},"linkPrefix":{"description":"Public booking link prefix","nullable":true,"type":"string"},"status":{"description":"Event activation status","nullable":true,"type":"string","enum":["ACTIVATED","DEACTIVATED"]},"allowReschedule":{"description":"Whether invitees can reschedule","nullable":true,"type":"boolean"},"phonePreferred":{"description":"Whether phone input is preferred","nullable":true,"type":"boolean"},"splitFullName":{"description":"Whether first/last names are collected separately","nullable":true,"type":"boolean"},"businessEmail":{"description":"Whether business email is required/enforced","nullable":true,"type":"boolean"},"disableDuplicateBooking":{"description":"Whether duplicate bookings are blocked","nullable":true,"type":"boolean"},"lockHostOnReschedule":{"description":"Whether host remains fixed on reschedule","nullable":true,"type":"boolean"},"dateRangeDays":{"description":"Number of days included in booking range","nullable":true,"type":"number"},"bypassQuestion":{"description":"Whether invitee questions are bypassed","nullable":true,"type":"boolean"},"isConditionalRoutingDisabled":{"description":"When true, conditional routing is disabled and EventLogicGroup is empty","nullable":true,"type":"boolean"},"internalGuestEmails":{"description":"Emails included on every booking from this event","nullable":true,"type":"array","items":{"type":"string"}},"allowInviteeAdditionalGuests":{"description":"Whether invitees may add extra guest emails when booking","nullable":true,"type":"boolean"},"featureStatuses":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Feature tooltip summaries; present when showFeatureStatuses=true"},"children":[]}]}]}],"type":"object","properties":{"disqualification":{"nullable":true,"type":"object","properties":{"enabled":{"type":"boolean"},"rules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"action":{"type":"string"}},"required":["condition","action"],"additionalProperties":false}}},"required":["enabled","rules"],"additionalProperties":false},"conditionalRouting":{"nullable":true,"type":"object","properties":{"enabled":{"type":"boolean"},"rules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"routeTo":{"type":"string"}},"required":["condition","routeTo"],"additionalProperties":false}}},"required":["enabled","rules"],"additionalProperties":false},"dataIntelligence":{"nullable":true,"type":"object","properties":{"enabled":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"enabled":{"type":"boolean"}},"required":["label","enabled"],"additionalProperties":false}}},"required":["enabled","items"],"additionalProperties":false}},"required":["disqualification","conditionalRouting","dataIntelligence"],"additionalProperties":false},"eventImageId":{"description":"Linked event image record ID","nullable":true,"type":"number"},"accountId":{"description":"Owning account ID","type":"number"},"staticLink":{"description":"Static public link when configured","nullable":true,"type":"string"},"linkHashForPublic":{"description":"Hash segment for public link","nullable":true,"type":"string"},"optimizePriorityType":{"description":"Host routing optimization mode (e.g. MANUAL)","nullable":true,"type":"string"},"dateRangeFrom":{"description":"Booking range start","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"dateRangeTo":{"description":"Booking range end","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"breakBefore":{"description":"Break duration before event","nullable":true,"type":"number"},"breakAfter":{"description":"Break duration after event","nullable":true,"type":"number"},"breakBeforeUnit":{"description":"Unit for break before","nullable":true,"type":"string"},"breakAfterUnit":{"description":"Unit for break after","nullable":true,"type":"string"},"limitation":{"description":"Scheduling limitation value","nullable":true,"type":"number"},"limitationUnit":{"description":"Unit for scheduling limitation","nullable":true,"type":"string"},"confirmationPageType":{"description":"Confirmation page destination type","nullable":true,"type":"string"},"replyWithHost":{"description":"Whether replies include host","nullable":true,"type":"boolean"},"includeLinkInEmail":{"description":"Whether booking link is included in emails","nullable":true,"type":"boolean"},"confirmationLink":{"description":"Custom confirmation link","nullable":true,"type":"string"},"addMiniEmbed":{"description":"Whether mini embed is enabled","nullable":true,"type":"boolean"},"enableParamsForwarding":{"description":"Whether query params are forwarded","nullable":true,"type":"boolean"},"confirmationEmailSubject":{"description":"Invitee confirmation email subject (HTML)","nullable":true,"type":"string"},"confirmationEmailBody":{"description":"Invitee confirmation email body (HTML)","nullable":true,"type":"string"},"cancellationEmailSubject":{"description":"Invitee cancellation email subject (HTML)","nullable":true,"type":"string"},"cancellationEmailBody":{"description":"Invitee cancellation email body (HTML)","nullable":true,"type":"string"},"confirmationEmailSubjectForCloser":{"description":"Host confirmation email subject (HTML)","nullable":true,"type":"string"},"confirmationEmailBodyForCloser":{"description":"Host confirmation email body (HTML)","nullable":true,"type":"string"},"cancellationEmailSubjectForCloser":{"description":"Host cancellation email subject (HTML)","nullable":true,"type":"string"},"cancellationEmailBodyForCloser":{"description":"Host cancellation email body (HTML)","nullable":true,"type":"string"},"disqualifiedMessage":{"description":"Message shown when invitee is disqualified","nullable":true,"type":"string"},"disqualifiedRedirectUrl":{"description":"Redirect URL for disqualified invitees","nullable":true,"type":"string"},"breakType":{"description":"Break configuration type","nullable":true,"type":"string"},"timeSlots":{"description":"Time slot increment in minutes","nullable":true,"type":"number"},"widgetColor":{"description":"Scheduler widget accent (CSS)","nullable":true,"type":"string"},"backgroundColor":{"description":"Scheduler background color","nullable":true,"type":"string"},"hideEventDetails":{"description":"Whether event details are hidden on widget","nullable":true,"type":"boolean"},"fontColor":{"description":"Scheduler text color","nullable":true,"type":"string"},"borderColor":{"description":"Scheduler border color","nullable":true,"type":"string"},"inputFieldsColor":{"description":"Form input background color","nullable":true,"type":"string"},"buttonFontColor":{"description":"Button text color","nullable":true,"type":"string"},"showHostAvatars":{"description":"Whether host avatars are shown","nullable":true,"type":"boolean"},"timeSensitiveBooking":{"description":"Whether time-sensitive booking copy is shown","nullable":true,"type":"boolean"},"timeSensitiveBookingMessage":{"description":"Copy for time-sensitive booking","nullable":true,"type":"string"},"highlightFirstField":{"description":"Whether first form field is highlighted","nullable":true,"type":"boolean"},"showWidgetTopHeader":{"description":"Whether the widget top header is shown","nullable":true,"type":"boolean"},"schedulerTheme":{"description":"Scheduler theme preset","nullable":true,"type":"string"},"timeSelectionView":{"description":"Calendar/time selection layout","nullable":true,"type":"string"},"autoExtendDays":{"description":"Whether bookable range auto-extends","nullable":true,"type":"boolean"},"arrangedByAI":{"description":"Whether event was arranged by AI","nullable":true,"type":"boolean"},"showCalendarWithForm":{"description":"Whether calendar shows alongside form","nullable":true,"type":"boolean"},"cookiesAllowed":{"description":"Cookie consent / usage flag","nullable":true,"type":"boolean"},"hideQuestionLabels":{"description":"Whether question labels are hidden","nullable":true,"type":"boolean"},"collapseAnswers":{"description":"Whether answers are collapsed in UI","nullable":true,"type":"boolean"},"customizationTipClosed":{"description":"Whether customization tip was dismissed","nullable":true,"type":"boolean"},"format12Hour":{"description":"Whether 12-hour time format is used","nullable":true,"type":"boolean"},"enableConfirmationEmail":{"description":"Whether invitee confirmation emails send","nullable":true,"type":"boolean"},"enableCancellationEmail":{"description":"Whether cancellation emails send","nullable":true,"type":"boolean"},"createdAt":{"description":"Event creation time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"updatedAt":{"description":"Event last update time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"disqualifyIfCreditNotAvailable":{"description":"Whether invitees are disqualified when credit is unavailable","nullable":true,"type":"boolean"},"disqualifyIfFingerprintNotAvailable":{"description":"Whether invitees are disqualified when security features data is unavailable","nullable":true,"type":"boolean"},"disqualifyIfNoHubspotProperties":{"description":"Whether invitees are disqualified when HubSpot properties are unavailable","nullable":true,"type":"boolean"},"isDefaultNotification":{"description":"Whether default notification template is used","type":"boolean"},"optimizationPriorities":{"description":"Host priority order for routing","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Optimization-priority record ID"},"priority":{"description":"Priority rank value","nullable":true,"type":"number"},"userId":{"description":"Referenced user ID","nullable":true,"type":"number"},"eventId":{"description":"Referenced event ID","nullable":true,"type":"number"},"user":{"description":"Referenced user summary","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"User ID"},"firstName":{"description":"User first name","nullable":true,"type":"string"},"lastName":{"description":"User last name","nullable":true,"type":"string"},"email":{"description":"User email","nullable":true,"type":"string"},"profilePictureKey":{"description":"User profile-picture storage key","nullable":true,"type":"string"},"previewId":{"description":"User preview/public identifier","nullable":true,"type":"string"},"signedUrl":{"description":"Temporary signed URL for profile picture","nullable":true,"type":"string"},"userAccounts":{"description":"User-account relationship metadata","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"UserAccount record ID"},"accountId":{"type":"number","description":"Account ID"},"userId":{"type":"number","description":"User ID"},"tagId":{"description":"Tag ID on the membership","nullable":true,"type":"number"},"trackedUser":{"description":"Whether user is tracked for this account","nullable":true,"type":"boolean"},"status":{"description":"Membership status","nullable":true,"type":"string"},"lastConnected":{"description":"Last connection time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"inviteNotAccepted":{"description":"Whether account invite is pending","nullable":true,"type":"boolean"},"restore":{"description":"Restore metadata","nullable":true,"type":"object"},"readyToRestore":{"description":"Ready-to-restore flag","nullable":true,"type":"object"},"createdAt":{"description":"Record creation time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"updatedAt":{"description":"Record last update time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"deletedAt":{"description":"Soft-delete timestamp","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]}},"required":["id","accountId","userId"],"additionalProperties":false}},"calendarConnected":{"description":"Whether calendar integration is connected","type":"boolean"},"zoomConnected":{"description":"Whether Zoom integration is connected","type":"boolean"},"inviteNotAccepted":{"description":"Whether invite has not been accepted","nullable":true,"type":"boolean"},"activeAvailability":{"description":"Currently active availability","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Availability profile ID"},"name":{"description":"Availability profile name","nullable":true,"type":"string"},"timeZone":{"description":"Timezone of this availability profile","nullable":true,"type":"string"},"availabilityDays":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Availability-day ID"},"name":{"type":"string","description":"Weekday name"},"timings":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","description":"Start time for this availability window"},"endTime":{"type":"string","description":"End time for this availability window"}},"required":["startTime","endTime"],"additionalProperties":false},"description":"Time windows configured for this day"},"active":{"type":"boolean","description":"Whether this weekday is active for scheduling"}},"required":["id","name","timings","active"],"additionalProperties":false},"description":"Availability days under this profile"}},"required":["id","availabilityDays"],"additionalProperties":false},"availabilitySet":{"description":"Whether user has availability configured","nullable":true,"type":"boolean"}},"required":["id"],"additionalProperties":false}},"required":["id"],"additionalProperties":false}},"inviteeQuestions":{"description":"Invitee questions configured for this event","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Invitee question ID"},"statement":{"description":"Question text shown to invitees","nullable":true,"type":"string"},"type":{"description":"Stored question type","nullable":true,"type":"string"},"required":{"description":"Whether answer is required","nullable":true,"type":"boolean"},"options":{"description":"Raw options payload for selectable question types","nullable":true,"type":"object"},"inputType":{"description":"Normalized invitee input category","nullable":true,"type":"string","enum":["FIRST_NAME","LAST_NAME","NAME","EMAIL","PHONE_NO"]},"displayIndex":{"description":"Display order of the question","nullable":true,"type":"number"},"deletedAt":{"description":"Soft-delete timestamp","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]}},"required":["id"],"additionalProperties":false}},"workflowEvents":{"description":"Workflows triggered by event lifecycle","type":"array","items":{"type":"object","properties":{"workflow":{"type":"object","properties":{"id":{"type":"number","description":"Workflow ID"},"eventCallStateId":{"description":"Linked event-call state ID","nullable":true,"type":"number"},"name":{"description":"Workflow name","nullable":true,"type":"string"},"immediate":{"description":"Whether workflow runs immediately","nullable":true,"type":"boolean"},"minutes":{"description":"Delay amount for scheduled workflow","nullable":true,"type":"number"},"unit":{"description":"Delay unit for scheduled workflow","nullable":true,"type":"string"},"disabled":{"description":"Whether workflow is disabled","nullable":true,"type":"boolean"}},"required":["id"],"additionalProperties":false,"description":"Workflow metadata linked to the event"}},"required":["workflow"],"additionalProperties":false}},"EventRules":{"description":"Rules associated with this event","type":"array","items":{"type":"object","properties":{"rule":{"type":"object","properties":{"id":{"type":"number","description":"Rule ID"},"name":{"description":"Rule name","nullable":true,"type":"string"},"type":{"description":"Rule type","nullable":true,"type":"string"},"disabled":{"description":"Whether rule is disabled","nullable":true,"type":"boolean"},"multiBookingConditions":{"description":"Multi-booking conditions","type":"array","items":{"type":"object","properties":{"customFieldEvent":{"description":"Referenced custom-field mapping","nullable":true,"type":"object","properties":{"customFieldId":{"description":"Referenced custom-field ID","nullable":true,"type":"number"}},"additionalProperties":false},"customFieldEventId":{"description":"Custom-field mapping ID","nullable":true,"type":"number"},"condition":{"description":"Condition join/value mode","nullable":true,"type":"string"},"value":{"description":"Rule comparison value","nullable":true,"type":"string"},"operator":{"description":"Rule comparison operator","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false,"description":"Rule linked to this event"}},"required":["rule"],"additionalProperties":false}},"routingMode":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Event-level host routing mode (SPECIFIC_HOSTS_TEAMS vs PRIORITIZE_BY_AVAILABILITY)"},"children":[]}]}]}],"nullable":true,"type":"string","enum":["SPECIFIC_HOSTS_TEAMS","PRIORITIZE_BY_AVAILABILITY"]},"EventLogicGroup":{"description":"Conditional host assignment logic groups","type":"array","items":{"type":"object","properties":{"id":{"description":"EventLogicGroup ID","type":"number"},"rank":{"description":"Unused; reserved for future branch ordering","nullable":true,"type":"number"},"minSlotsCheck":{"description":"Deprecated: superseded by EventLogicFallback","nullable":true,"type":"boolean"},"EventLogicUsers":{"description":"Branch routing targets (teams and/or specific hosts)","type":"array","items":{"type":"object","properties":{"userId":{"description":"Host user ID (XOR with teamId)","nullable":true,"type":"number"},"teamId":{"description":"Team ID (XOR with userId)","nullable":true,"type":"number"},"priority":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Arrangement within branch/fallback pool (1 = highest)"},"children":[]}]}]}],"nullable":true,"type":"number"},"user":{"description":"Host user summary when userId is set","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"User ID"},"email":{"description":"User email","nullable":true,"type":"string"},"firstName":{"description":"User first name","nullable":true,"type":"string"},"lastName":{"description":"User last name","nullable":true,"type":"string"},"profilePictureKey":{"description":"Profile-picture storage key","nullable":true,"type":"string"},"signedUrl":{"description":"Temporary signed URL for profile picture","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"team":{"description":"Team summary when teamId is set","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Team ID"},"name":{"description":"Team name","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false}},"additionalProperties":false}},"EventLogicFallbacks":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SPECIFIC_HOSTS_TEAMS availability waterfall steps"},"children":[]}]}]}],"type":"array","items":{"type":"object","properties":{"id":{"description":"Fallback row ID","type":"number"},"stepOrder":{"description":"Top-to-bottom order of fallback conditions","nullable":true,"type":"number"},"slotThreshold":{"description":"Widen pool when slots fall below this","nullable":true,"type":"number"},"expandAllHosts":{"description":"All-hosts expand option (API write key: allHost)","nullable":true,"type":"boolean"},"EventLogicUsers":{"description":"Expand-pool targets (teams and/or hosts)","type":"array","items":{"type":"object","properties":{"userId":{"description":"Host user ID (XOR with teamId)","nullable":true,"type":"number"},"teamId":{"description":"Team ID (XOR with userId)","nullable":true,"type":"number"},"priority":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Arrangement within branch/fallback pool (1 = highest)"},"children":[]}]}]}],"nullable":true,"type":"number"},"user":{"description":"Host user summary when userId is set","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"User ID"},"email":{"description":"User email","nullable":true,"type":"string"},"firstName":{"description":"User first name","nullable":true,"type":"string"},"lastName":{"description":"User last name","nullable":true,"type":"string"},"profilePictureKey":{"description":"Profile-picture storage key","nullable":true,"type":"string"},"signedUrl":{"description":"Temporary signed URL for profile picture","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"team":{"description":"Team summary when teamId is set","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Team ID"},"name":{"description":"Team name","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false}},"additionalProperties":false}}},"additionalProperties":false}},"EventLogics":{"description":"Logic rules in this group","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Event-logic rule ID"},"eventId":{"description":"Parent event ID","nullable":true,"type":"number"},"inviteeQuestionId":{"description":"Referenced invitee-question ID","nullable":true,"type":"number"},"customFieldId":{"description":"Referenced custom-field ID","nullable":true,"type":"number"},"condition":{"description":"Condition join/value mode","nullable":true,"type":"string"},"value":{"description":"Rule comparison value","nullable":true,"type":"string"},"operator":{"description":"Rule comparison operator","nullable":true,"type":"string"},"customField":{"description":"Raw custom-field payload used by the rule","nullable":true,"type":"object"},"customFieldEvent":{"description":"Raw event custom-field mapping payload","nullable":true,"type":"object"}},"required":["id"],"additionalProperties":false}}},"additionalProperties":false}},"CustomFieldEventMap":{"description":"Mapped secondary/custom fields for this event","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"CustomFieldEventMap record ID"},"statement":{"description":"Question/field statement shown in event form","nullable":true,"type":"string"},"required":{"description":"Whether this field is required","nullable":true,"type":"boolean"},"displayIndex":{"description":"Display order index","nullable":true,"type":"number"},"customField":{"description":"Custom-field definition payload","oneOf":[{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["TEXT"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"No selectable options for TEXT","type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field event map item: inputType TEXT. Example: { \"id\": 7972, \"identifier\": \"what-is-e\", \"description\": \"\", \"inputType\": \"TEXT\", \"options\": \"\", \"optionsAttributes\": null, \"type\": \"CALL\", \"CustomFieldOptions\": [] }"},"children":[]}]}]}],"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["TEXT_AREA"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"No selectable options for TEXT_AREA"},"children":[]}]}]}],"type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field event map item: inputType TEXT_AREA. Example: { \"id\": 7973, \"identifier\": \"explain-element\", \"description\": \"\", \"inputType\": \"TEXT_AREA\", \"options\": \"\", \"optionsAttributes\": null, \"type\": \"CALL\", \"CustomFieldOptions\": [] }"},"children":[]}]}]}],"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["NUMBER"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"No selectable options for NUMBER","type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field event map item: inputType NUMBER. Example: { \"id\": 7977, \"identifier\": \"num\", \"description\": \"\", \"inputType\": \"NUMBER\", \"options\": \"\", \"optionsAttributes\": null, \"type\": \"CALL\", \"CustomFieldOptions\": [] }"},"children":[]}]}]}],"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["URL"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"No selectable options for URL","type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field event map item: inputType URL. Example: { \"id\": 11996, \"identifier\": \"add-url\", \"description\": null, \"inputType\": \"URL\", \"options\": \"\", \"optionsAttributes\": null, \"type\": \"CALL\", \"CustomFieldOptions\": [] }"},"children":[]}]}]}],"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["DATE"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"No selectable options for DATE","type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field event map item: inputType DATE. Example: { \"id\": 35113, \"identifier\": \"date-time\", \"description\": \"\", \"inputType\": \"DATE\", \"options\": \"\", \"optionsAttributes\": null, \"type\": \"CALL\", \"CustomFieldOptions\": [] }"},"children":[]}]}]}],"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized selectable-options definition","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["SINGLE_SELECT"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"Resolved selectable options","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom-field option ID"},"name":{"description":"Option label","nullable":true,"type":"string"},"color":{"description":"Display color","nullable":true,"type":"string"},"badge":{"description":"Badge text","nullable":true,"type":"string"},"tooltip":{"description":"Tooltip text","nullable":true,"type":"string"},"isArchived":{"description":"Whether option is archived","nullable":true,"type":"boolean"},"displayIndex":{"description":"Display order index","nullable":true,"type":"number"},"actionId":{"description":"Associated action ID","nullable":true,"type":"number"},"category":{"description":"Option category","nullable":true,"type":"string","enum":["ACTIVE","WON","LOST"]},"icon":{"description":"Icon key/name","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default","nullable":true,"type":"boolean"}},"required":["id"],"additionalProperties":false}}},"required":["id","inputType"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field event map item: inputType SINGLE_SELECT. Example: { \"id\": 13015, \"identifier\": \"zain-test\", \"description\": \"\", \"inputType\": \"SINGLE_SELECT\", \"options\": \"[{\"w1\":false},{\"21w\":false}]\", \"optionsAttributes\": null, \"type\": \"CALL\", \"CustomFieldOptions\": [{ \"id\": 54038, \"name\": \"w1\", \"color\": null, \"badge\": null, \"tooltip\": null, \"isArchived\": false, \"displayIndex\": 0, \"actionId\": null }, { \"id\": 54138, \"name\": \"21w\", \"color\": null, \"badge\": null, \"tooltip\": null, \"isArchived\": false, \"displayIndex\": 1, \"actionId\": null }] }"},"children":[]}]}]}],"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized selectable-options definition","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["MULTIPLE_SELECT"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"Resolved selectable options","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom-field option ID"},"name":{"description":"Option label","nullable":true,"type":"string"},"color":{"description":"Display color","nullable":true,"type":"string"},"badge":{"description":"Badge text","nullable":true,"type":"string"},"tooltip":{"description":"Tooltip text","nullable":true,"type":"string"},"isArchived":{"description":"Whether option is archived","nullable":true,"type":"boolean"},"displayIndex":{"description":"Display order index","nullable":true,"type":"number"},"actionId":{"description":"Associated action ID","nullable":true,"type":"number"},"category":{"description":"Option category","nullable":true,"type":"string","enum":["ACTIVE","WON","LOST"]},"icon":{"description":"Icon key/name","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default","nullable":true,"type":"boolean"}},"required":["id"],"additionalProperties":false}}},"required":["id","inputType"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field event map item: inputType MULTIPLE_SELECT. Example: { \"id\": 15794, \"identifier\": \"what-specific-breakthroasfasughs-are-you-\", \"description\": \"\", \"inputType\": \"MULTIPLE_SELECT\", \"options\": \"[{\"asfasfsfsf\":false},{\"asfasf\":false},{\"bretta\":false},{\"wrangler\":false}]\", \"optionsAttributes\": null, \"type\": \"CALL\", \"CustomFieldOptions\": [{ \"id\": 47790, \"name\": \"asfasf\", \"displayIndex\": 1 }, { \"id\": 47853, \"name\": \"asfasfsfsf\", \"displayIndex\": 0 }, { \"id\": 659889, \"name\": \"bretta\", \"displayIndex\": 2 }, { \"id\": 659890, \"name\": \"wrangler\", \"displayIndex\": 3 }] }"},"children":[]}]}]}],"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized selectable-options definition","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["CHECK_BOX"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"Resolved selectable options","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom-field option ID"},"name":{"description":"Option label","nullable":true,"type":"string"},"color":{"description":"Display color","nullable":true,"type":"string"},"badge":{"description":"Badge text","nullable":true,"type":"string"},"tooltip":{"description":"Tooltip text","nullable":true,"type":"string"},"isArchived":{"description":"Whether option is archived","nullable":true,"type":"boolean"},"displayIndex":{"description":"Display order index","nullable":true,"type":"number"},"actionId":{"description":"Associated action ID","nullable":true,"type":"number"},"category":{"description":"Option category","nullable":true,"type":"string","enum":["ACTIVE","WON","LOST"]},"icon":{"description":"Icon key/name","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default","nullable":true,"type":"boolean"}},"required":["id"],"additionalProperties":false}}},"required":["id","inputType"],"additionalProperties":false,"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized selectable-options definition","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["RADIO_BUTTON"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"Resolved selectable options","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom-field option ID"},"name":{"description":"Option label","nullable":true,"type":"string"},"color":{"description":"Display color","nullable":true,"type":"string"},"badge":{"description":"Badge text","nullable":true,"type":"string"},"tooltip":{"description":"Tooltip text","nullable":true,"type":"string"},"isArchived":{"description":"Whether option is archived","nullable":true,"type":"boolean"},"displayIndex":{"description":"Display order index","nullable":true,"type":"number"},"actionId":{"description":"Associated action ID","nullable":true,"type":"number"},"category":{"description":"Option category","nullable":true,"type":"string","enum":["ACTIVE","WON","LOST"]},"icon":{"description":"Icon key/name","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default","nullable":true,"type":"boolean"}},"required":["id"],"additionalProperties":false}}},"required":["id","inputType"],"additionalProperties":false,"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["EMAIL"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"No selectable options for EMAIL","type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["RATING"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"No selectable options for RATING","type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["USER"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":"No selectable options for USER","type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"nullable":true},{"type":"object","properties":{"id":{"type":"number","description":"Custom-field ID"},"identifier":{"description":"Custom-field identifier/slug","nullable":true,"type":"string"},"description":{"description":"Custom-field description","nullable":true,"type":"string"},"options":{"description":"Serialized options payload","nullable":true,"type":"string"},"optionsAttributes":{"description":"Serialized options-attributes payload","nullable":true,"type":"string"},"type":{"description":"Custom-field scope/type","nullable":true,"type":"string","enum":["CONTACT","EVENT","CALL","DEAL","SHARED","BACK_OFFICE","USER","TRANSACTION","SETTER","CONTACT_STATS","COMMUNICATION","UNIFIED_INBOX","ISCORE","CREDITSCORE","FPJS"]},"inputType":{"type":"string","enum":["USERS_MULTIPLE"],"description":"Custom-field input type"},"CustomFieldOptions":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"No selectable options for USERS_MULTIPLE"},"children":[]}]}]}],"type":"array","items":{"anyOf":[]},"minItems":0,"maxItems":0}},"required":["id","inputType"],"additionalProperties":false,"nullable":true}]}},"required":["id"],"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One custom field event map entry. customField is discriminated by inputType (TEXT, TEXT_AREA, NUMBER, URL, DATE, SINGLE_SELECT, MULTIPLE_SELECT, etc.). Examples: TEXT { \"id\": 114695, \"statement\": \"What is E\", \"required\": false, \"displayIndex\": 0, \"customField\": { \"id\": 7972, \"identifier\": \"what-is-e\", \"inputType\": \"TEXT\", \"type\": \"CALL\", \"CustomFieldOptions\": [] } }; SINGLE_SELECT { \"id\": 114697, \"statement\": \"witch\", \"required\": true, \"displayIndex\": 2, \"customField\": { \"id\": 13015, \"identifier\": \"zain-test\", \"inputType\": \"SINGLE_SELECT\", \"options\": \"[{\"w1\":false},{\"21w\":false}]\", \"type\": \"CALL\", \"CustomFieldOptions\": [{ \"id\": 54038, \"name\": \"w1\", \"displayIndex\": 0 }, { \"id\": 54138, \"name\": \"21w\", \"displayIndex\": 1 }] } }."},"children":[]}]}]}]}},"DisqualificationLogicGroup":{"description":"Disqualification rules and redirect behavior","type":"array","items":{"type":"object","properties":{"redirectUrl":{"description":"Redirect URL used when disqualification rules match","nullable":true,"type":"string"},"delayForDisqualificationRedirect":{"description":"Delay in seconds before redirecting disqualified invitees to a URL","nullable":true,"type":"integer"},"EventConditionalLogics":{"description":"Conditional rules in this disqualification group","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Conditional-logic rule ID"},"eventId":{"description":"Parent event ID","nullable":true,"type":"number"},"statement":{"description":"Question/field statement referenced by this rule","nullable":true,"type":"string"},"operator":{"description":"Comparison operator used for evaluation","nullable":true,"type":"string"},"value":{"description":"Comparison value used by the rule","nullable":true,"type":"string"},"condition":{"description":"Condition join type (e.g. AND/OR semantics)","nullable":true,"type":"string"},"disqualificationGroupId":{"description":"Parent disqualification logic-group ID","nullable":true,"type":"number"}},"required":["id"],"additionalProperties":false}}},"additionalProperties":false}},"eventImage":{"description":"Event image metadata","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Event image record ID"},"imageUrl":{"description":"Stored image URL","nullable":true,"type":"string"},"imageKey":{"description":"Storage key for event image","nullable":true,"type":"string"},"signedUrl":{"description":"Temporary signed URL for image access","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"account":{"description":"Account-level settings snapshot","nullable":true,"type":"object","properties":{"emailValidationEnabled":{"description":"Account-level email validation setting","nullable":true,"type":"boolean"},"phoneNumberValidationEnabled":{"description":"Account-level phone validation setting","nullable":true,"type":"boolean"},"usCreditCheckEnabled":{"description":"Account-level US credit-check setting","nullable":true,"type":"boolean"},"signedUrl":{"description":"Temporary signed URL for account media","nullable":true,"type":"string"}},"additionalProperties":false},"user":{"description":"Primary user summary","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"User ID"},"firstName":{"description":"User first name","nullable":true,"type":"string"},"lastName":{"description":"User last name","nullable":true,"type":"string"},"email":{"description":"User email","nullable":true,"type":"string"},"profilePictureKey":{"description":"User profile-picture storage key","nullable":true,"type":"string"},"previewId":{"description":"User preview/public identifier","nullable":true,"type":"string"},"signedUrl":{"description":"Temporary signed URL for profile picture","nullable":true,"type":"string"},"userAccounts":{"description":"User-account relationship metadata","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"UserAccount record ID"},"accountId":{"type":"number","description":"Account ID"},"userId":{"type":"number","description":"User ID"},"tagId":{"description":"Tag ID on the membership","nullable":true,"type":"number"},"trackedUser":{"description":"Whether user is tracked for this account","nullable":true,"type":"boolean"},"status":{"description":"Membership status","nullable":true,"type":"string"},"lastConnected":{"description":"Last connection time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"inviteNotAccepted":{"description":"Whether account invite is pending","nullable":true,"type":"boolean"},"restore":{"description":"Restore metadata","nullable":true,"type":"object"},"readyToRestore":{"description":"Ready-to-restore flag","nullable":true,"type":"object"},"createdAt":{"description":"Record creation time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"updatedAt":{"description":"Record last update time","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"deletedAt":{"description":"Soft-delete timestamp","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]}},"required":["id","accountId","userId"],"additionalProperties":false}},"calendarConnected":{"description":"Whether calendar integration is connected","type":"boolean"},"zoomConnected":{"description":"Whether Zoom integration is connected","type":"boolean"},"inviteNotAccepted":{"description":"Whether invite has not been accepted","nullable":true,"type":"boolean"},"activeAvailability":{"description":"Currently active availability","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Availability profile ID"},"name":{"description":"Availability profile name","nullable":true,"type":"string"},"timeZone":{"description":"Timezone of this availability profile","nullable":true,"type":"string"},"availabilityDays":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Availability-day ID"},"name":{"type":"string","description":"Weekday name"},"timings":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","description":"Start time for this availability window"},"endTime":{"type":"string","description":"End time for this availability window"}},"required":["startTime","endTime"],"additionalProperties":false},"description":"Time windows configured for this day"},"active":{"type":"boolean","description":"Whether this weekday is active for scheduling"}},"required":["id","name","timings","active"],"additionalProperties":false},"description":"Availability days under this profile"}},"required":["id","availabilityDays"],"additionalProperties":false},"availabilitySet":{"description":"Whether user has availability configured","nullable":true,"type":"boolean"}},"required":["id"],"additionalProperties":false},"eventEmailTemplateVariables":{"description":"Template variables used in event emails","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Template-variable record ID"},"eventId":{"description":"Parent event ID","nullable":true,"type":"number"},"variableKey":{"description":"Template variable key","nullable":true,"type":"string"},"variableValue":{"description":"Template variable value","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"additionalProperties":false},"id":"schema_229"},"schema_230":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":true,"maximum":2147483647,"description":"Event ID","minimum":0},"status":{"type":"string","enum":["ACTIVATED","DEACTIVATED"],"description":"Event status"}},"required":["id","status"],"additionalProperties":false,"example":{"id":4,"status":"ACTIVATED"}},"id":"schema_230"},"schema_231":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Status-update result message","type":"string"},"status":{"description":"HTTP status code","type":"number"}},"additionalProperties":false},"id":"schema_231"},"schema_232":{"kind":"json-schema","data":{"type":"string","minLength":1,"description":"Public event link prefix"},"id":"schema_232"},"schema_233":{"kind":"json-schema","data":{"type":"string","minLength":1,"description":"Date to troubleshoot"},"id":"schema_233"},"schema_234":{"kind":"json-schema","data":{"type":"string","minLength":1,"description":"IANA timezone used for slot generation (must match app-supported timezones)"},"id":"schema_234"},"schema_235":{"kind":"json-schema","data":{"description":"Optional host user ID to pin results","type":"integer","exclusiveMinimum":true,"maximum":2147483647,"minimum":0},"id":"schema_235"},"schema_236":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"slots":{"type":"array","items":{"type":"object","properties":{"slot":{"type":"string","description":"Display time label (e.g. \"12:00 AM\", \"03:45 PM\")"},"tags":{"type":"array","items":{"type":"string"},"description":"Reasons the slot is unavailable (e.g. \"Time range is in past\")"},"reason":{"nullable":true,"description":"Human-readable reason when slot is unavailable","type":"string"},"availableUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"User ID"},"firstName":{"description":"User first name","nullable":true,"type":"string"},"lastName":{"description":"User last name","nullable":true,"type":"string"},"email":{"description":"User email","nullable":true,"type":"string"},"phoneNumber":{"description":"User phone number","nullable":true,"type":"string"},"profilePictureKey":{"description":"Profile picture storage key","nullable":true,"type":"string"},"signedUrl":{"description":"Temporary signed URL for profile picture","nullable":true,"type":"string"},"extraDetails":{"description":"Additional host-specific metadata","nullable":true,"type":"object"}},"required":["id"],"additionalProperties":false},"description":"Users available for this slot"},"unAvailableUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"User ID"},"firstName":{"description":"User first name","nullable":true,"type":"string"},"lastName":{"description":"User last name","nullable":true,"type":"string"},"profilePictureKey":{"description":"Profile picture storage key","nullable":true,"type":"string"},"inviteNotAccepted":{"description":"Whether user invite is still pending acceptance","type":"boolean"},"signedUrl":{"description":"Temporary signed URL for profile picture","nullable":true,"type":"string"},"reason":{"description":"Why this user is unavailable for this slot (e.g. matches tags)","type":"string"},"busyDetails":{"description":"Underlying busy interval metadata when applicable","type":"object","properties":{"userId":{"type":"number"},"accountId":{"type":"number"},"googleEventId":{"description":"Google Calendar event id, or Microsoft Graph event id (same field for both integrations)","type":"string"},"name":{"description":"Calendar event title when from an external calendar","type":"string"},"reason":{"type":"string"},"overBooked":{"type":"boolean"},"startDate":{"anyOf":[{"type":"string"},{"type":"string","format":"date-time"}]},"endDate":{"anyOf":[{"type":"string"},{"type":"string","format":"date-time"}]},"source":{"description":"Present for busy intervals from a connected calendar (Google vs Outlook/Microsoft)","type":"string","enum":["googleCalendar","microsoftCalendar"]}},"additionalProperties":false}},"required":["id"],"additionalProperties":false},"description":"Users that are not available for this slot"},"datetime":{"type":"string","description":"Slot start time as epoch milliseconds string"}},"required":["slot","tags","reason","availableUsers","unAvailableUsers","datetime"],"additionalProperties":false},"description":"Generated slots with host availability details"},"noOfAvailableSlots":{"type":"number","description":"Number of slots that have at least one available user"}},"required":["slots","noOfAvailableSlots"],"additionalProperties":false,"description":"Troubleshoot-slots payload"}},"required":["data"],"additionalProperties":false},"id":"schema_236"},"schema_237":{"kind":"json-schema","data":{"type":"object","properties":{"linkPrefix":{"type":"string","minLength":1,"description":"Public event link prefix"},"timeZone":{"description":"Timezone used to generate available dates","type":"string"},"currentDate":{"description":"Current date anchor for date generation","type":"string"},"conditionalUsers":{"description":"Optional comma-separated user IDs to constrain host selection. Echo from inviteeAnswers.conditionalUsers (join with commas). When eventDates returns appliedHostIds, use those instead for create.","type":"string"},"routingGroupIds":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional comma-separated EventLogicGroup IDs the lead matched. Echo from inviteeAnswers.routingGroupIds (join with commas). Used for PRIORITIZE_BY_AVAILABILITY host union and SPECIFIC_HOSTS_TEAMS waterfall fallbacks."},"children":[]}]}]}],"type":"string"}},"required":["linkPrefix"],"additionalProperties":false,"example":{"linkPrefix":"company/discovery-call","timeZone":"America/New_York","currentDate":"2026-04-15","conditionalUsers":"101,102","routingGroupIds":"10"}},"id":"schema_237"},"schema_238":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"isPreview":{"description":"Whether returned dates are preview-only","type":"boolean"},"availabilities":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Date-keyed map of available slot times"},"appliedHostIds":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SPECIFIC_HOSTS_TEAMS waterfall: expanded host pool used to build the shown availability. When present, pass these IDs as conditionalUsers when creating the event call so assignment matches the slots shown."},"children":[]}]}]}],"type":"array","items":{"type":"number"}}},"required":["availabilities"],"additionalProperties":false,"description":"Public event-date availability payload"}},"required":["data"],"additionalProperties":false},"id":"schema_238"},"schema_239":{"kind":"json-schema","data":{"description":"Case-insensitive product name search term.","type":"string"},"id":"schema_239"},"schema_240":{"kind":"json-schema","data":{"default":20,"description":"Maximum number of records returned per page (1-200).","type":"integer","minimum":1,"maximum":200},"id":"schema_240"},"schema_241":{"kind":"json-schema","data":{"default":0,"description":"Zero-based page index used with limit for pagination.","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_241"},"schema_242":{"kind":"json-schema","data":{"type":"string","enum":["id","name","createdAt","updatedAt","deals"]},"id":"schema_242"},"schema_243":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"count":{"description":"Total number of matching records for pagination.","type":"number"},"products":{"description":"Product records returned for the current page.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Unique product identifier."},"tagId":{"description":"Associated tag identifier for the product.","type":"number"},"name":{"description":"Product name.","type":"string"},"description":{"description":"Product description text.","type":"string"},"price":{"description":"Product price value when available.","type":"number"},"contractValue":{"description":"Contract value used by legacy product flows.","type":"number"},"accountId":{"description":"Owning account identifier for the product record.","type":"number"},"createdAt":{"description":"ISO timestamp when the product was created.","type":"string"},"updatedAt":{"description":"ISO timestamp when the product was last updated.","type":"string"},"tag":{"description":"Tag relation details when loaded.","type":"object","properties":{"id":{"type":"number","description":"Unique tag identifier."},"name":{"type":"string","description":"Tag display name associated with the product."},"createdAt":{"type":"string","description":"ISO timestamp when the tag was created."}},"required":["id","name","createdAt"],"additionalProperties":false},"_count":{"type":"object","properties":{"deals":{"type":"number","description":"Number of non-deleted deals linked to this product."}},"required":["deals"],"additionalProperties":false,"description":"Aggregated relation counts included when count data is requested."}},"required":["id"],"additionalProperties":false}}},"additionalProperties":false,"description":"Paginated products payload for list responses."}},"required":["data"],"additionalProperties":false},"id":"schema_243"},"schema_244":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40,"description":"Name for the new product (max 40 chars)."},"description":{"description":"Optional description for the new product.","type":"string"}},"required":["name"],"additionalProperties":false,"example":{"name":"Premium Plan","description":"Annual subscription tier"}},"id":"schema_244"},"schema_245":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"product":{"description":"Product payload returned on successful create or update.","type":"object","properties":{"id":{"type":"number","description":"Unique product identifier."},"tagId":{"description":"Associated tag identifier for the product.","type":"number"},"name":{"description":"Product name.","type":"string"},"description":{"description":"Product description text.","type":"string"},"price":{"description":"Product price value when available.","type":"number"},"contractValue":{"description":"Contract value used by legacy product flows.","type":"number"},"accountId":{"description":"Owning account identifier for the product record.","type":"number"},"createdAt":{"description":"ISO timestamp when the product was created.","type":"string"},"updatedAt":{"description":"ISO timestamp when the product was last updated.","type":"string"},"tag":{"description":"Tag relation details when loaded.","type":"object","properties":{"id":{"type":"number","description":"Unique tag identifier."},"name":{"type":"string","description":"Tag display name associated with the product."},"createdAt":{"type":"string","description":"ISO timestamp when the tag was created."}},"required":["id","name","createdAt"],"additionalProperties":false},"_count":{"type":"object","properties":{"deals":{"type":"number","description":"Number of non-deleted deals linked to this product."}},"required":["deals"],"additionalProperties":false,"description":"Aggregated relation counts included when count data is requested."}},"required":["id"],"additionalProperties":false},"error":{"description":"Service error payload returned when operation fails."}},"additionalProperties":false,"description":"Create/update result payload containing either product or error details."}},"required":["data"],"additionalProperties":false},"id":"schema_245"},"schema_246":{"kind":"json-schema","data":{"type":"object","properties":{"productId":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Identifier of the product to update."},"name":{"description":"New product name (max 40 chars).","type":"string","minLength":1,"maxLength":40},"description":{"description":"Updated product description.","type":"string"}},"required":["productId"],"additionalProperties":false,"example":{"productId":4,"name":"Premium Plan","description":"Updated product description"}},"id":"schema_246"},"schema_247":{"kind":"json-schema","data":{"type":"object","properties":{"outcome":{"type":"string","enum":["WON","NO_SALE","APPROVED","REJECTED"],"description":"Task outcome for the selected event call."},"noSaleReason":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required when outcome is NO_SALE."},"children":[]}]}]}],"type":"string","enum":["FOLLOW_UP_SCHEDULE","UNQUALIFIED","NO_SHOW","CONTACT_CANCELLED","ADMIN_CANCELLED","NOT_INTERESTED","BAD_FIT","OTHER"]},"notes":{"description":"Free-text notes stored with the task outcome.","type":"string"},"objection":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required for WON and certain NO_SALE reasons."},"children":[]}]}]}],"type":"string","enum":["MONEY","LOGISTIC","PARTNER","FEAR","SMOKE_SCREEN","NO_OBJECTION"]},"newDeal":{"description":"Deal payload used when posting a WON outcome.","type":"object","properties":{"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Existing deal id: updates that deal only; never creates a new deal. Cannot be used together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transactionIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":0,"maximum":2147483647},"value":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deal value for manual create or update; ignored for creation when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transactionIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set (value comes from transaction sum)."},"children":[]}]}]}],"type":"number"},"transactionType":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Transaction type on the deal; required for manual new-deal create (no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transactionIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","enum":["WON","RECURRING","DEPOSIT"]},"productId":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Product id for the deal; required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newDeal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is present; validated to exist for the account."},"children":[]}]}]}],"type":"integer","minimum":0,"maximum":2147483647},"date":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO datetime for deal time; required for manual new-deal create; optional when updating by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or creating via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transactionIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (defaults apply in service)."},"children":[]}]}]}],"type":"string","format":"date-time"},"transactionIds":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a new deal from these transactions (aggregated value). Cannot be used together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"type":"integer","minimum":0,"maximum":2147483647}}},"additionalProperties":false},"eventCallId":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Event call id used to locate and update its linked task."}},"required":["outcome","eventCallId"],"additionalProperties":false},"id":"schema_247"},"schema_248":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"description":"Updated task record returned by updateTask.","type":"object","properties":{"id":{"description":"Task id that was updated.","type":"number"},"noSaleReason":{"description":"Persisted no-sale reason on the task.","nullable":true,"type":"string","enum":["FOLLOW_UP_SCHEDULE","UNQUALIFIED","NO_SHOW","CONTACT_CANCELLED","ADMIN_CANCELLED","NOT_INTERESTED","BAD_FIT","OTHER"]},"objection":{"description":"Persisted objection category on the task.","nullable":true,"type":"string","enum":["MONEY","LOGISTIC","PARTNER","FEAR","SMOKE_SCREEN","NO_OBJECTION"]},"updatedAt":{"description":"Last task update timestamp.","type":"string"}},"additionalProperties":false}},"additionalProperties":false},"id":"schema_248"},"schema_249":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50,"description":"Custom field display name."},"identifier":{"description":"Optional unique identifier for API-based lookup.","type":"string","maxLength":1000},"description":{"description":"Optional field description text.","type":"string","maxLength":150},"inputType":{"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"],"description":"Input type for value capture and validation."},"type":{"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"],"description":"Object type this field is attached to."},"configuration":{"description":"Optional input-type-specific configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"options":{"description":"Selectable options for select-like input types (name, color enum, displayIndex only).","type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50,"description":"Option display label."},"color":{"nullable":true,"description":"Semantic color token, or null when the option has no color.","type":"string","enum":["blue","indigo","purple","green","yellow","red","pink","gray"]},"displayIndex":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Ordering index for option display."}},"required":["name","color","displayIndex"],"additionalProperties":false,"description":"Custom field option for create/update requests."}},"isSecondaryQuestion":{"description":"Marks field as a secondary question in invitee flow i.e. Invitee Question. If true and type is CALL then the field will be created as invitee question else the type will be the type in payload i.e. CONTACT or CALL","type":"boolean"}},"required":["name","inputType","type"],"additionalProperties":false,"example":{"name":"Lead source","identifier":"lead-source","description":"Where the lead originated","inputType":"SINGLE_SELECT","type":"CONTACT","configuration":{"isColorCodeOptions":true},"options":[{"name":"Inbound","color":"blue","displayIndex":0},{"name":"Outbound","color":"gray","displayIndex":1}]}},"id":"schema_249"},"schema_250":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Operation result message.","type":"string"},"status":{"description":"HTTP-like status code from API layer.","type":"number"},"data":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"associationCount":{"description":"Number of linked associations/answers.","nullable":true,"type":"number"},"name":{"description":"Custom field display name.","nullable":true,"type":"string"},"identifier":{"description":"Programmatic identifier for this field.","nullable":true,"type":"string"},"description":{"description":"Field description text.","nullable":true,"type":"string"},"inputType":{"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"],"description":"Configured input type."},"type":{"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"],"description":"Object type this field belongs to."},"subType":{"description":"Optional subtype metadata from service/DB.","nullable":true,"type":"string"},"isSecondaryQuestion":{"description":"Whether field is marked as invitee secondary question. If true and type is CALL then the field will be created as invitee question else the type will be the type in payload i.e. CONTACT or CALL","nullable":true,"type":"boolean"},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"configuration":{"description":"Type-specific configuration returned with the field.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Field creation timestamp."},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Field last update timestamp."},"CustomFieldOptions":{"default":[],"description":"Field options returned by create/update response.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Option ID."},"color":{"description":"Option color value.","nullable":true,"type":"string"},"name":{"description":"Option label text.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Whether option is archived.","nullable":true,"type":"boolean"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Option creation timestamp."},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Option last update timestamp."}},"required":["id","createdAt","updatedAt"],"additionalProperties":false}}},"required":["id","inputType","type","createdAt","updatedAt","CustomFieldOptions"],"additionalProperties":false,"description":"Created custom field payload."}},"required":["data"],"additionalProperties":false},"id":"schema_250"},"schema_251":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Custom field ID to update."},"name":{"description":"Updated display name.","type":"string","maxLength":50},"identifier":{"description":"Updated programmatic identifier.","type":"string","maxLength":1000},"description":{"description":"Updated description text.","type":"string","maxLength":150},"configuration":{"description":"Updated type-specific configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"options":{"description":"Updated option list for select-like types (name, color enum, displayIndex only).","type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50,"description":"Option display label."},"color":{"nullable":true,"description":"Semantic color token, or null when the option has no color.","type":"string","enum":["blue","indigo","purple","green","yellow","red","pink","gray"]},"displayIndex":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Ordering index for option display."}},"required":["name","color","displayIndex"],"additionalProperties":false,"description":"Custom field option for create/update requests."}},"hidden":{"description":"Updated hidden flag.","type":"boolean"},"isSecondaryQuestion":{"description":"Updated secondary-question flag for invitee flow.","type":"boolean"}},"required":["id"],"additionalProperties":false,"example":{"id":20660,"name":"Lead source","identifier":"lead-source","description":"Where the lead originated","configuration":{"isColorCodeOptions":true},"options":[{"name":"Inbound","color":"blue","displayIndex":0},{"name":"Outbound","color":"gray","displayIndex":1}],"hidden":false}},"id":"schema_251"},"schema_252":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Operation result message.","type":"string"},"status":{"description":"HTTP-like status code from API layer.","type":"number"},"data":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"associationCount":{"description":"Number of linked associations/answers.","nullable":true,"type":"number"},"name":{"description":"Custom field display name.","nullable":true,"type":"string"},"identifier":{"description":"Programmatic identifier for this field.","nullable":true,"type":"string"},"description":{"description":"Field description text.","nullable":true,"type":"string"},"inputType":{"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"],"description":"Configured input type."},"type":{"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"],"description":"Object type this field belongs to."},"subType":{"description":"Optional subtype metadata from service/DB.","nullable":true,"type":"string"},"isSecondaryQuestion":{"description":"Whether field is marked as invitee secondary question. If true and type is CALL then the field will be created as invitee question else the type will be the type in payload i.e. CONTACT or CALL","nullable":true,"type":"boolean"},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"configuration":{"description":"Type-specific configuration returned with the field.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Field creation timestamp."},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Field last update timestamp."},"CustomFieldOptions":{"default":[],"description":"Field options returned by create/update response.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Option ID."},"color":{"description":"Option color value.","nullable":true,"type":"string"},"name":{"description":"Option label text.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Whether option is archived.","nullable":true,"type":"boolean"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Option creation timestamp."},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Option last update timestamp."}},"required":["id","createdAt","updatedAt"],"additionalProperties":false}}},"required":["id","inputType","type","createdAt","updatedAt","CustomFieldOptions"],"additionalProperties":false,"description":"Updated custom field payload."}},"required":["data"],"additionalProperties":false},"id":"schema_252"},"schema_253":{"kind":"json-schema","data":{"type":"object","properties":{"customFieldId":{"description":"Target custom field ID (use either this or identifier).","type":"integer","minimum":1,"maximum":2147483647},"identifier":{"description":"Target custom field identifier (use either this or customFieldId).","type":"string","minLength":1,"maxLength":1000},"answer":{"description":"Answer payload as string array. Interpretation depends on inputType.","nullable":true,"type":"array","items":{"type":"string"}},"contactId":{"description":"Required when field type is CONTACT.","type":"integer","minimum":1,"maximum":2147483647},"eventCallId":{"description":"Required when field type is CALL.","type":"integer","minimum":1,"maximum":2147483647}},"additionalProperties":false},"id":"schema_253"},"schema_254":{"kind":"json-schema","data":{"type":"object","properties":{"contactId":{"description":"Contact ID for CONTACT-type association.","type":"number"},"createdAt":{"description":"Association creation timestamp.","anyOf":[{"type":"string","format":"date-time"},{"type":"string"}]},"updatedBy":{"description":"User metadata for updater of the association.","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"User ID of actor who last updated answer association."},"firstName":{"description":"First name of updater.","nullable":true,"type":"string"},"lastName":{"description":"Last name of updater.","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"contact":{"description":"Flattened contact payload for association.","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Contact ID linked to this answer association."},"firstName":{"description":"Contact first name.","nullable":true,"type":"string"},"lastName":{"description":"Contact last name.","nullable":true,"type":"string"},"email":{"description":"Contact email address.","nullable":true,"type":"string"},"previewId":{"description":"Preview/public contact identifier when used.","nullable":true,"type":"string"},"phoneNumber":{"description":"Contact phone number.","nullable":true,"type":"string"},"status":{"description":"Contact status value from contact record.","nullable":true,"type":"string"},"joinedTime":{"description":"Contact joined timestamp.","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]}},"required":["id"],"additionalProperties":false},"CustomFieldAnswer":{"description":"Detailed answer entries linked to the association.","type":"array","items":{"type":"object","properties":{"customFieldRelationId":{"type":"number","description":"Association/relation ID for this answer row."},"inputType":{"description":"Input type of the answered field.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"answer":{"description":"Raw stored answer string representation.","nullable":true,"type":"string"},"number":{"description":"Numeric projection of answer when applicable.","nullable":true,"type":"number"},"date":{"description":"Date projection of answer when applicable.","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"customFieldOptionId":{"description":"Selected custom field option ID when applicable.","nullable":true,"type":"number"},"user":{"nullable":true,"type":"object","properties":{"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Related user ID for USER/USERS_MULTIPLE answers."},"children":[]}]}]}],"type":"number"},"firstName":{"description":"Related user first name.","nullable":true,"type":"string"},"lastName":{"description":"Related user last name.","nullable":true,"type":"string"}},"additionalProperties":false},"userId":{"description":"Related user ID (flat form).","nullable":true,"type":"number"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Answer row creation timestamp."}},"required":["customFieldRelationId","createdAt"],"additionalProperties":false}},"customField":{"description":"Metadata of the custom field that was answered.","type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Custom field name.","nullable":true,"type":"string"},"inputType":{"description":"Custom field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Custom field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"isSystemField":{"description":"Whether custom field is system-defined.","type":"boolean"},"identifier":{"description":"Custom field identifier.","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"message":{"description":"Operation result message.","type":"string"}},"additionalProperties":false},"id":"schema_254"},"schema_255":{"kind":"json-schema","data":{"type":"object","properties":{"customFieldId":{"description":"Target custom field ID (use either this or identifier).","type":"integer","minimum":1,"maximum":2147483647},"identifier":{"description":"Target custom field identifier (use either this or customFieldId).","type":"string","minLength":1,"maxLength":1000},"answer":{"description":"Answer payload as string array. Interpretation depends on inputType.","nullable":true,"type":"array","items":{"type":"string"}},"contactIds":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"description":"Contact IDs to apply the answer to (CONTACT-type fields only). Maximum 10,000 IDs per request."},"overrideExisting":{"description":"When true, replace existing answers for these contacts. When false or omitted, skip contacts that already have an answer.","type":"boolean"}},"required":["contactIds"],"additionalProperties":false},"id":"schema_255"},"schema_256":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Operation result message.","type":"string"}},"additionalProperties":false},"id":"schema_256"},"schema_257":{"kind":"json-schema","data":{"type":"object","properties":{"linkPrefix":{"type":"string","minLength":1,"description":"Event link prefix used to resolve target event."},"contactId":{"description":"Contact ID to attach answers to (use with authenticated contact context).","type":"integer","minimum":0,"maximum":2147483647},"previewId":{"description":"Alternative contact reference when contactId is not provided.","type":"string"},"inviteeQuestionAnswers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["EMAIL","PHONE_NO","NAME","FIRST_NAME","LAST_NAME"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Answer type (e.g. EMAIL, PHONE_NO, NAME); must match an invitee question type on the event"},"children":[]}]}]}]},"answer":{"type":"string","description":"Answer value"}},"required":["type","answer"],"additionalProperties":false},"description":"Primary invitee question answers."},"secondaryQuestionsAnswer":{"default":[],"description":"Secondary custom-field question answers.","type":"array","items":{"type":"object","properties":{"customFieldId":{"description":"Secondary custom field ID resolved against event configuration.","type":"integer","minimum":0,"maximum":2147483647},"identifier":{"description":"Secondary custom field identifier resolved against event configuration.","type":"string","minLength":1},"answer":{"type":"array","items":{"type":"string"},"description":"Answer value(s); always an array"}},"required":["answer"],"additionalProperties":false}},"publicSessionId":{"description":"Optional public session identifier for event-call session correlation.","type":"string"},"timeZone":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional IANA timezone (e.g. America/New_York). Considered for conditional routing and disqualification."},"children":[]}]}]}],"type":"string","minLength":1}},"required":["linkPrefix","inviteeQuestionAnswers","secondaryQuestionsAnswer"],"additionalProperties":false},"id":"schema_257"},"schema_258":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"message":{"description":"Operation result message.","type":"string"},"disqualifyingCondition":{"description":"Triggered disqualification logic entries, if any.","type":"array","items":{"type":"object","additionalProperties":{}}},"conditionalUsers":{"description":"Host user IDs from matched routing branches (direct users and expanded team members). Pass as a comma-separated string to eventDates and create. Empty when no branch matched.","type":"array","items":{"type":"number"}},"routingGroupIds":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Matched EventLogicGroup IDs. Pass as a comma-separated string to eventDates and create. Required for PRIORITIZE_BY_AVAILABILITY assignment and SPECIFIC_HOSTS_TEAMS waterfall fallbacks."},"children":[]}]}]}],"type":"array","items":{"type":"number"}},"routingMode":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Event-level host routing mode. Echo routingGroupIds and conditionalUsers for both modes; use appliedHostIds from eventDates when the SPECIFIC_HOSTS_TEAMS waterfall widens the pool."},"children":[]}]}]}],"nullable":true,"type":"string","enum":["SPECIFIC_HOSTS_TEAMS","PRIORITIZE_BY_AVAILABILITY"]},"isDisqualified":{"description":"True when at least one disqualification condition is triggered.","type":"boolean"}},"additionalProperties":false,"description":"Invitee answer processing result payload."}},"required":["data"],"additionalProperties":false},"id":"schema_258"},"schema_259":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"number","description":"Contact stage custom field ID."},"name":{"description":"Contact stage field name.","nullable":true,"type":"string"},"identifier":{"description":"Contact stage field identifier.","nullable":true,"type":"string"},"description":{"description":"Contact stage field description.","nullable":true,"type":"string"},"inputType":{"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"],"description":"Input type of the contact stage field."},"type":{"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"],"description":"Object type of the contact stage field."},"CustomFieldOptions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Option ID."},"name":{"description":"Option display name.","nullable":true,"type":"string"},"displayIndex":{"description":"Ordering index for contact stage option.","nullable":true,"type":"number"},"isArchived":{"description":"Archive flag for option.","nullable":true,"type":"boolean"},"category":{"description":"Grouping category (for example ACTIVE/LOST).","nullable":true,"type":"string"},"icon":{"description":"Optional icon descriptor for stage option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default stage.","nullable":true,"type":"boolean"},"isSystemOption":{"description":"Whether option is system-provided.","nullable":true,"type":"boolean"},"color":{"description":"Optional color assigned to stage option.","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"description":"Flat list of contact stage options."},"CustomFieldOptionsGrouped":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Option ID."},"name":{"description":"Option display name.","nullable":true,"type":"string"},"displayIndex":{"description":"Ordering index for contact stage option.","nullable":true,"type":"number"},"isArchived":{"description":"Archive flag for option.","nullable":true,"type":"boolean"},"category":{"description":"Grouping category (for example ACTIVE/LOST).","nullable":true,"type":"string"},"icon":{"description":"Optional icon descriptor for stage option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default stage.","nullable":true,"type":"boolean"},"isSystemOption":{"description":"Whether option is system-provided.","nullable":true,"type":"boolean"},"color":{"description":"Optional color assigned to stage option.","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false}},"description":"Stage options grouped by category key."}},"required":["id","inputType","type","CustomFieldOptions","CustomFieldOptionsGrouped"],"additionalProperties":false},"id":"schema_259"},"schema_260":{"kind":"json-schema","data":{"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"id":"schema_260"},"schema_261":{"kind":"json-schema","data":{"description":"Zero-based page index.","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_261"},"schema_262":{"kind":"json-schema","data":{"default":20,"description":"Maximum number of fields returned per page.","type":"integer","minimum":1,"maximum":100},"id":"schema_262"},"schema_263":{"kind":"json-schema","data":{"description":"Search term applied on field name/identifier in service layer.","type":"string","maxLength":1000},"id":"schema_263"},"schema_264":{"kind":"json-schema","data":{"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"id":"schema_264"},"schema_265":{"kind":"json-schema","data":{"description":"Comma-separated field identifiers filter.","type":"string","maxLength":500},"id":"schema_265"},"schema_266":{"kind":"json-schema","data":{"type":"object","properties":{"count":{"type":"number","description":"Total number of matching fields."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Field creation timestamp."},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"CustomFieldOptions":{"description":"Field options list for select-like fields.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color token/value when available.","nullable":true,"type":"string"},"badge":{"description":"Badge text shown for option when configured.","nullable":true,"type":"string"},"tooltip":{"description":"Tooltip text shown for option when configured.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive state of option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor/value for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether this option is the default option.","nullable":true,"type":"boolean"},"actionId":{"description":"Linked action ID for option, when present.","nullable":true,"type":"number"},"category":{"description":"Grouping category key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id","createdAt"],"additionalProperties":false},"description":"Paginated field items."},"hasMore":{"type":"boolean","description":"Whether a next page exists."},"nextPage":{"description":"Next page index when hasMore is true.","type":"number"}},"required":["count","data","hasMore"],"additionalProperties":false},"id":"schema_266"},"schema_267":{"kind":"json-schema","data":{"default":20,"description":"Maximum number of items per object-type slice.","type":"integer","minimum":1,"maximum":100},"id":"schema_267"},"schema_268":{"kind":"json-schema","data":{"description":"Search term applied in service layer.","type":"string","maxLength":1000},"id":"schema_268"},"schema_269":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"CONTACT":{"description":"Custom fields for CONTACT object type.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"CALL":{"description":"Custom fields for CALL object type.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"EVENT":{"description":"Custom fields for EVENT object type.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"DEAL":{"description":"Custom fields for DEAL object type.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"USER":{"description":"Custom fields for USER object type.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"UNIFIED_INBOX":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom fields for UNIFIED_INBOX object type."},"children":[]}]}]}],"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"INVITEE_QUESTION":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom fields for INVITEE_QUESTION object type."},"children":[]}]}]}],"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}},"ISCORE":{"description":"Custom fields for ISCORE object type.","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Custom field ID."},"name":{"description":"Field display name.","nullable":true,"type":"string"},"identifier":{"description":"Field identifier key.","nullable":true,"type":"string"},"inputType":{"description":"Field input type.","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"type":{"description":"Field object type.","nullable":true,"type":"string","enum":["CONTACT","CALL","EVENT","DEAL","USER","ISCORE"]},"configuration":{"description":"Field configuration object.","anyOf":[{"type":"object","properties":{"dateTimeFormat":{"type":"string","enum":["12Hour","24Hour"],"description":"Time format: \"12Hour\" or \"24Hour\". Required when includedTime is true."},"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[true],"description":"When true, time is shown and dateTimeFormat applies."}},"required":["dateTimeFormat","dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is selected.","nullable":true},{"type":"object","properties":{"dateType":{"type":"string","enum":["US","EU","ISO","FRIENDLY"],"description":"Date display format: \"US\", \"EU\", \"ISO\", or \"FRIENDLY\"."},"includedTime":{"type":"boolean","enum":[false],"description":"When false, only date is shown; no dateTimeFormat."}},"required":["dateType","includedTime"],"additionalProperties":false,"description":"Date field configuration when time is not selected.","nullable":true},{"type":"object","properties":{"isColorCodeOptions":{"type":"boolean","description":"True if options have colors; false if colors are not selected for options."}},"required":["isColorCodeOptions"],"additionalProperties":false,"description":"Single Select or Multi Select field configuration.","nullable":true},{"type":"object","properties":{"isMultipleUsers":{"type":"boolean","description":"True to allow multiple users; false for single user selection."}},"required":["isMultipleUsers"],"additionalProperties":false,"description":"User field configuration.","nullable":true},{"type":"object","properties":{"maxRating":{"type":"string","description":"Maximum rating value as string (e.g. \"3\")."},"ratingStyle":{"type":"string","enum":["STAR"],"description":"Display style for the rating (e.g. \"STAR\")."}},"required":["maxRating","ratingStyle"],"additionalProperties":false,"description":"Rating field configuration.","nullable":true},{"type":"object","properties":{"showMaxValue":{"type":"boolean","description":"Whether to show the maximum value."}},"required":["showMaxValue"],"additionalProperties":false,"description":"Number field configuration.","nullable":true}]},"isSystemField":{"description":"Whether field is system-defined.","nullable":true,"type":"boolean"},"hidden":{"description":"Whether field is hidden.","nullable":true,"type":"boolean"},"slug":{"description":"Optional slug-like key returned by service.","type":"string"},"isSecondaryQuestion":{"description":"Whether field is a secondary question.","nullable":true,"type":"boolean"},"createdAt":{"description":"Field creation timestamp.","type":"string","format":"date-time"},"CustomFieldOptions":{"description":"Options for select-like field types.","nullable":true,"type":"array","items":{"type":"object","properties":{"id":{"description":"Option ID.","type":"number"},"name":{"description":"Option display name.","nullable":true,"type":"string"},"color":{"description":"Option color.","nullable":true,"type":"string"},"displayIndex":{"description":"Option ordering index.","nullable":true,"type":"number"},"isArchived":{"description":"Archive status for option.","nullable":true,"type":"boolean"},"icon":{"description":"Icon descriptor for option.","nullable":true,"type":"string"},"isDefault":{"description":"Whether option is default value.","nullable":true,"type":"boolean"},"category":{"description":"Category/group key for option.","nullable":true,"type":"string"}},"additionalProperties":false}}},"required":["id"],"additionalProperties":false}}},"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_269"},"schema_270":{"kind":"json-schema","data":{"type":"object","properties":{"contactId":{"description":"Contact ID (optional if email or phoneNumber is provided)","type":"integer","minimum":0,"maximum":2147483647},"email":{"description":"Invitee email (required when contactId is not provided); must be valid when provided","anyOf":[{"type":"string","maxLength":255,"format":"email"},{"type":"string","enum":[""]}]},"phoneNumber":{"description":"Invitee phone (required when contactId is not provided); must be valid when provided","type":"string"},"firstName":{"description":"Invitee first name","type":"string"},"lastName":{"description":"Invitee last name","type":"string"},"eventId":{"description":"Event ID (optional if linkPrefix is provided)","type":"integer","minimum":0,"maximum":2147483647},"linkPrefix":{"description":"Event link prefix (e.g. \"company/meeting\"); resolved to eventId when provided","type":"string","minLength":1},"dateTime":{"type":"string","minLength":1,"format":"date-time","description":"ISO 8601 date-time in UTC (e.g. 2026-02-27T12:00:00.000Z)"},"timeZone":{"type":"string","minLength":1,"description":"IANA time zone for the booking. Also considered for conditional routing (Timezone rules)."},"conditionalUsers":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional comma-separated host user IDs. Echo from inviteeAnswers.conditionalUsers, or from eventDates.appliedHostIds when the SPECIFIC_HOSTS_TEAMS waterfall widened the pool."},"children":[]}]}]}],"type":"string"},"routingGroupIds":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Matched EventLogicGroup ids (comma-separated). Echo from inviteeAnswers.routingGroupIds. Required for PRIORITIZE_BY_AVAILABILITY so team arrangement priority is preserved; also selects SPECIFIC_HOSTS_TEAMS waterfall fallbacks."},"children":[]}]}]}],"type":"string"},"useSecondaryQuestionsForConditionalRouting":{"description":"Optional flag to use secondary questions for conditional routing. Only works when conditionalUsers are not provided. If true and no conditional users are available at the given dateTime, the API throws \"No closer available for this slot.\"","type":"boolean"},"secondaryQuestionsAnswer":{"default":[],"description":"Optional secondary custom field answers to attach when creating the booking","type":"array","items":{"type":"object","properties":{"customFieldId":{"description":"Custom field ID (use when identifier is not provided)","type":"integer","minimum":0,"maximum":2147483647},"identifier":{"description":"Custom field identifier/slug (use when customFieldId is not provided)","type":"string","minLength":1},"answer":{"type":"array","items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Answer value(s); always an array (one element for single-value types, multiple for MULTIPLE_SELECT)"},"children":[]}]}]}]}},"required":["answer"],"additionalProperties":false}},"additionalGuests":{"description":"Optional extra attendees when the event has allowInviteeAdditionalGuests (max 5); merged with internal host list server-side","maxItems":5,"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Additional guest email"},"name":{"description":"Optional display name","type":"string","maxLength":500}},"required":["email"],"additionalProperties":false}}},"required":["dateTime","timeZone","secondaryQuestionsAnswer"],"additionalProperties":false},"id":"schema_270"},"schema_271":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"eventCall":{"type":"object","properties":{"message":{"type":"string","description":"Success message"},"status":{"type":"integer","minimum":0,"maximum":2147483647,"description":"HTTP status"},"data":{"type":"object","properties":{"startTime":{"type":"string","description":"Booking start time (ISO 8601)"},"endTime":{"type":"string","description":"Booking end time (ISO 8601)"},"id":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Created event call ID"},"closerId":{"type":"integer","minimum":0,"maximum":2147483647,"description":"User ID assigned to the call"},"timeZone":{"type":"string","description":"Call timezone"},"guestEmail":{"type":"string","description":"Invitee email"},"token":{"type":"string","description":"Encrypted link (e.g. for confirmation page)"},"closerName":{"type":"string","description":"Assigned user full name"},"previewId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Event call preview ID (e.g. call_xxxx)"},"children":[]}]}]}]},"closerEmail":{"type":"string","description":"Assigned user email"},"redirectUrl":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to redirect the invitee to after booking. Present only when the event’s confirmationPageType is EXTERNAL."},"children":[]}]}]}],"type":"string"},"confirmationLink":{"type":"string","description":"Event confirmation link"}},"required":["startTime","endTime","id","closerId","timeZone","guestEmail","token","closerName","previewId","closerEmail","confirmationLink"],"additionalProperties":false,"description":"Created event call payload"}},"required":["message","status","data"],"additionalProperties":false}},"required":["eventCall"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_271"},"schema_272":{"kind":"json-schema","data":{"description":"Comma-separated event call IDs to include","type":"string"},"id":"schema_272"},"schema_273":{"kind":"json-schema","data":{"description":"Filter by contact ID","type":"integer","exclusiveMinimum":true,"maximum":2147483647,"minimum":0},"id":"schema_273"},"schema_274":{"kind":"json-schema","data":{"type":"string","enum":["PAST","UPCOMING","ALL"]},"id":"schema_274"},"schema_275":{"kind":"json-schema","data":{"description":"Free-text search across invitee/contact name, email, and phone","type":"string"},"id":"schema_275"},"schema_276":{"kind":"json-schema","data":{"description":"Start of date range filter (inclusive)","type":"string"},"id":"schema_276"},"schema_277":{"kind":"json-schema","data":{"description":"End of date range filter (inclusive)","type":"string"},"id":"schema_277"},"schema_278":{"kind":"json-schema","data":{"description":"Start of creation date range filter (inclusive)","type":"string"},"id":"schema_278"},"schema_279":{"kind":"json-schema","data":{"description":"End of creation date range filter (inclusive)","type":"string"},"id":"schema_279"},"schema_280":{"kind":"json-schema","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated location filter values (e.g. PHONE_CALL,GOOGLE_MEET)"},"children":[]}]}]}],"type":"string"},"id":"schema_280"},"schema_281":{"kind":"json-schema","data":{"type":"string","enum":["createdAt","dateTime","updatedAt","id"]},"id":"schema_281"},"schema_282":{"kind":"json-schema","data":{"default":20,"description":"Maximum number of records per page","type":"integer","minimum":1,"maximum":100},"id":"schema_282"},"schema_283":{"kind":"json-schema","data":{"description":"Comma-separated assigned user IDs","type":"string"},"id":"schema_283"},"schema_284":{"kind":"json-schema","data":{"description":"Comma-separated event template IDs","type":"string"},"id":"schema_284"},"schema_285":{"kind":"json-schema","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: rescheduled_events, cancelled_events, scheduled_events"},"children":[]}]}]}],"type":"string"},"id":"schema_285"},"schema_286":{"kind":"json-schema","data":{"description":"Comma-separated invitee email addresses","type":"string"},"id":"schema_286"},"schema_287":{"kind":"json-schema","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: WON, NO_SALE, QUALIFIED, UNQUALIFIED, PENDING, APPROVED, REJECTED, PENDING_OUTCOME"},"children":[]}]}]}],"type":"string"},"id":"schema_287"},"schema_288":{"kind":"json-schema","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: FOLLOW_UP_SCHEDULE, UNQUALIFIED, NO_SHOW, CONTACT_CANCELLED, ADMIN_CANCELLED, NOT_INTERESTED, BAD_FIT, OTHER"},"children":[]}]}]}],"type":"string"},"id":"schema_288"},"schema_289":{"kind":"json-schema","data":{"description":"Comma-separated UTM parameter keys to filter by","type":"string"},"id":"schema_289"},"schema_290":{"kind":"json-schema","data":{"description":"Comma-separated UTM parameter values to filter by","type":"string"},"id":"schema_290"},"schema_291":{"kind":"json-schema","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated. Allowed values: STRATEGY_EVENT, DISCOVERY_EVENT"},"children":[]}]}]}],"type":"string"},"id":"schema_291"},"schema_292":{"kind":"json-schema","data":{"description":"Comma-separated setter user IDs linked via SettedClaim","type":"string"},"id":"schema_292"},"schema_293":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"eventCalls":{"description":"List of matching event calls","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Event call ID"},"eventId":{"type":"number","description":"Event template ID"},"dateTime":{"type":"string","description":"Event call start date-time"},"userId":{"description":"Assigned closer user ID","nullable":true,"type":"integer","minimum":0,"maximum":2147483647},"location":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Location type (e.g. PHONE_CALL, GOOGLE_MEET)"},"children":[]}]}]}],"nullable":true,"type":"string"},"notes":{"description":"Notes attached to the event call","nullable":true,"type":"string"},"isCalendarConnected":{"description":"Whether calendar sync was connected at booking time","nullable":true,"type":"boolean"},"isZoomConnected":{"description":"Whether Zoom integration was connected at booking time","nullable":true,"type":"boolean"},"cancelReason":{"description":"Cancellation reason","nullable":true,"type":"string"},"locationLink":{"description":"Primary meeting location/join URL","nullable":true,"type":"string"},"locationLinkInvitee":{"description":"Invitee-facing location/join URL","nullable":true,"type":"string"},"rescheduledBy":{"description":"Actor that rescheduled the call","nullable":true,"type":"string"},"rescheduleReason":{"description":"Reason provided when call was rescheduled","nullable":true,"type":"string"},"cancelledBy":{"description":"Actor that cancelled the call","nullable":true,"type":"string"},"callType":{"description":"Event call type","nullable":true,"type":"string","enum":["STRATEGY_EVENT","DISCOVERY_EVENT"]},"isSlotFree":{"description":"Whether this event appears as free/busy-transparent","nullable":true,"type":"boolean"},"overBooked":{"description":"Overbooking count for this call instance","type":"number"},"totalOverBooked":{"description":"Total overbooking count for this slot","type":"number"},"breakBefore":{"description":"Break before this event call","type":"number"},"breakAfter":{"description":"Break after this event call","type":"number"},"createdAt":{"description":"Event call creation timestamp","type":"string"},"updatedAt":{"description":"Event call last update timestamp","type":"string"},"googleResponseStatus":{"description":"Google Calendar attendee/response status","nullable":true,"type":"string"},"additionalGuests":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merged additional attendees for this booking (internal list + invitee extras)"},"children":[]}]}]}],"nullable":true,"type":"array","items":{"type":"object","properties":{"email":{"type":"string","description":"Normalized email"},"source":{"type":"string","enum":["internal","invitee"],"description":"From event template list vs invitee form"},"name":{"description":"Optional display name","type":"string"}},"required":["email","source"],"additionalProperties":false}},"contactId":{"description":"Linked contact ID","nullable":true,"type":"number"},"user":{"description":"Assigned user summary","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Assigned user ID"},"firstName":{"description":"Assigned user first name","nullable":true,"type":"string"},"lastName":{"description":"Assigned user last name","nullable":true,"type":"string"},"email":{"description":"Assigned user email","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"callId":{"type":"number","description":"Underlying call record ID"},"deals":{"description":"Deals linked to the contact/event call","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Deal ID"},"value":{"type":"number","description":"Deal value amount"},"time":{"description":"Deal timestamp","nullable":true,"type":"string"},"transactionType":{"description":"Transaction type associated with the deal","nullable":true,"type":"string","enum":["WON","RECURRING","DEPOSIT"]},"product":{"description":"Product associated with the deal","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Product ID linked to the deal"},"name":{"description":"Product name","nullable":true,"type":"string"}},"required":["id"],"additionalProperties":false},"Transaction":{"description":"Transaction record linked to the deal","nullable":true,"type":"object","properties":{"id":{"type":"number","description":"Transaction ID linked to this deal"}},"required":["id"],"additionalProperties":false}},"required":["id","value"],"additionalProperties":false}},"task":{"description":"Linked task records","type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Task ID linked to the event call"},"completed":{"type":"boolean","description":"Whether the task has been completed"},"outcome":{"description":"Recorded task outcome","nullable":true,"type":"string"},"noSaleReason":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"No-sale reason when outcome is NO_SALE"},"children":[]}]}]}],"nullable":true,"type":"string"},"objection":{"description":"Primary objection captured for the task","nullable":true,"type":"string"},"notes":{"description":"Task notes entered by the user","nullable":true,"type":"string"}},"required":["id","completed"],"additionalProperties":false}},"inviteTimeZone":{"description":"Invitee-selected timezone","nullable":true,"type":"string"},"dateTimeUTC":{"description":"Event call start date-time normalized to UTC","type":"string"},"inviteeEmail":{"description":"Invitee email captured at booking","nullable":true,"type":"string"},"inviteeName":{"description":"Invitee full name captured at booking","nullable":true,"type":"string"},"phoneNumber":{"description":"Invitee/contact primary phone number","nullable":true,"type":"string"},"questions":{"description":"Invitee question/answer pairs","type":"array","items":{"type":"object","properties":{"statement":{"type":"string","description":"Invitee question text"},"answer":{"type":"string","description":"Invitee answer text"}},"required":["statement","answer"],"additionalProperties":false}},"secondaryAnswers":{"description":"Secondary custom field answers","type":"array","items":{"type":"object","properties":{"customFieldId":{"type":"number","description":"custom field ID"},"customFieldIdentifier":{"description":"custom field identifier","nullable":true,"type":"string"},"statement":{"description":"Secondary custom field question text","nullable":true,"type":"string"},"isSecondaryQuestion":{"description":"Whether this custom field is marked as secondary question","type":"boolean"},"answer":{"description":"Structured answer values for this secondary field","type":"array","items":{"type":"object","properties":{"inputType":{"description":"Custom field input type","nullable":true,"type":"string","enum":["NUMBER","TEXT","TEXT_AREA","DATE","CHECK_BOX","RADIO_BUTTON","CONTACT","CONTACTS_MULTIPLE","USER","USERS_MULTIPLE","URL","SINGLE_SELECT","MULTIPLE_SELECT","EMAIL","RATING"]},"answer":{"description":"String answer value","nullable":true,"type":"string"},"date":{"description":"Date answer value","nullable":true,"type":"string"},"userId":{"description":"User ID answer value when input type is user-based","nullable":true,"type":"number"},"number":{"description":"Numeric answer value","nullable":true,"type":"number"},"user":{"description":"Referenced user object for user-based answer values","nullable":true,"type":"object","properties":{"firstName":{"description":"Referenced user first name","nullable":true,"type":"string"},"lastName":{"description":"Referenced user last name","nullable":true,"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}},"required":["customFieldId"],"additionalProperties":false}},"eventType":{"type":"string","enum":["UPCOMING","PAST"],"description":"Computed timing classification relative to now"},"utm":{"description":"UTM attributes tied to the contact/event","type":"array","items":{"type":"object","properties":{"utmKey":{"type":"string","description":"UTM parameter key"},"utmValue":{"description":"UTM parameter value","nullable":true,"type":"string"}},"required":["utmKey"],"additionalProperties":false}},"contact":{"description":"Contact summary","nullable":true,"type":"object","properties":{"email":{"description":"Contact primary email","nullable":true,"type":"string"},"phoneNumber":{"description":"Contact primary phone number","nullable":true,"type":"string"},"previewId":{"description":"Contact preview ID","nullable":true,"type":"string"},"secondary_email":{"description":"Contact secondary email","nullable":true,"type":"string"},"secondary_phoneNumber":{"description":"Contact secondary phone number","nullable":true,"type":"string"}},"additionalProperties":false},"event":{"description":"Event template summary","nullable":true,"type":"object","properties":{"allowInviteeAdditionalGuests":{"description":"Whether invitee can add additional guests","nullable":true,"type":"boolean"},"allowReschedule":{"description":"Whether invitee can reschedule this event","nullable":true,"type":"boolean"},"color":{"description":"Event color","nullable":true,"type":"string"},"duration":{"description":"Default event duration","type":"number"},"durationUnit":{"description":"Default event duration unit","nullable":true,"type":"string"},"eventType":{"description":"Event type","nullable":true,"type":"string"},"internalDescription":{"description":"Internal event description","nullable":true,"type":"string"},"linkPrefix":{"description":"Public booking link prefix","nullable":true,"type":"string"},"location":{"description":"Event location type","nullable":true,"type":"string"},"name":{"description":"Event name","nullable":true,"type":"string"}},"additionalProperties":false}},"required":["id","eventId","dateTime","callId","eventType"],"additionalProperties":false}},"count":{"description":"Total number of matching event calls","type":"integer","minimum":0,"maximum":2147483647}},"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_293"},"schema_294":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":true,"maximum":2147483647,"description":"Event call ID to reschedule","minimum":0},"dateTime":{"type":"string","minLength":1,"description":"ISO 8601 date-time in UTC (e.g. 2026-02-27T12:00:00.000Z)"},"timeZone":{"type":"string","minLength":1,"description":"IANA time zone used to interpret the new dateTime"},"rescheduleReason":{"description":"Reason provided for rescheduling the event call","type":"string"},"notes":{"description":"Optional internal notes for this reschedule action","type":"string"},"userId":{"description":"Optional reassigned closer user ID","type":"integer","exclusiveMinimum":true,"maximum":2147483647,"minimum":0},"additionalGuests":{"description":"Optional replacement list of invitee-supplied extra guests when the event allows (max 5); omit to keep prior invitee extras out of merge","maxItems":5,"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Additional guest email"},"name":{"description":"Optional display name","type":"string","maxLength":500}},"required":["email"],"additionalProperties":false}}},"required":["id","dateTime","timeZone"],"additionalProperties":false,"example":{"id":1001,"dateTime":"2026-07-24T16:45:00.000Z","timeZone":"America/New_York","rescheduleReason":"Client requested a different time","notes":"Internal note for the reschedule","userId":101,"additionalGuests":[{"email":"colleague@example.com","name":"Alex Guest"}]}},"id":"schema_294"},"schema_295":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Success message"},"status":{"type":"integer","minimum":0,"maximum":2147483647,"description":"HTTP status"},"data":{"type":"object","properties":{"closerName":{"type":"string","description":"Assigned user full name"},"closerEmail":{"type":"string","description":"Assigned user email"},"dateTime":{"type":"string","description":"New date-time of the call (ISO 8601)"},"duration":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Call duration"},"durationUnit":{"type":"string","description":"Duration unit (e.g. MINUTES)"},"name":{"type":"string","description":"Event/call name"},"location":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Location type (e.g. GOOGLE_MEET)"},"children":[]}]}]}]},"inviteeEmail":{"type":"string","description":"Invitee email"},"inviteeName":{"type":"string","description":"Invitee name"},"previewId":{"type":"string","description":"Event call preview ID"},"userId":{"type":"integer","minimum":0,"maximum":2147483647,"description":"User ID assigned to the call"}},"required":["closerName","closerEmail","dateTime","duration","durationUnit","name","location","inviteeEmail","inviteeName","previewId","userId"],"additionalProperties":false}},"required":["message","status","data"],"additionalProperties":false},"id":"schema_295"},"schema_296":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Event call ID"},"cancelReason":{"description":"Reason for cancellation","type":"string"}},"required":["id"],"additionalProperties":false,"example":{"id":1001,"cancelReason":"Client requested cancellation"}},"id":"schema_296"},"schema_297":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"eventCall":{"type":"object","properties":{"message":{"type":"string","description":"Success message"},"status":{"type":"integer","minimum":0,"maximum":2147483647,"description":"HTTP status"}},"required":["message","status"],"additionalProperties":false}},"required":["eventCall"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_297"},"schema_298":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Event call ID"},"isSlotFree":{"type":"boolean","description":"Whether the slot is free (true) or busy (false)"}},"required":["id","isSlotFree"],"additionalProperties":false,"example":{"id":6,"isSlotFree":true}},"id":"schema_298"},"schema_299":{"kind":"json-schema","data":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether slot-free update succeeded"},"message":{"type":"string","description":"Result message"},"data":{"type":"object","properties":{"id":{"type":"number","description":"Updated event call ID"},"isSlotFree":{"type":"boolean","description":"Updated slot-free value"},"googleEventId":{"description":"Linked Google Calendar event ID when available","type":"string"}},"required":["id","isSlotFree"],"additionalProperties":false,"description":"Updated event call payload"}},"required":["success","message"],"additionalProperties":false},"id":"schema_299"},"schema_300":{"kind":"json-schema","data":{"description":"Filter by transaction ID.","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_300"},"schema_301":{"kind":"json-schema","data":{"description":"Search in name, email, phoneNumber, or value.","type":"string"},"id":"schema_301"},"schema_302":{"kind":"json-schema","data":{"type":"string","enum":["Zapier","Stripe","Make","Other"]},"id":"schema_302"},"schema_303":{"kind":"json-schema","data":{"description":"Filter transactions created on or after this time (ISO 8601).","type":"string","format":"date-time"},"id":"schema_303"},"schema_304":{"kind":"json-schema","data":{"description":"Filter by createdAt on or before this time (ISO 8601).","type":"string","format":"date-time"},"id":"schema_304"},"schema_305":{"kind":"json-schema","data":{"description":"Page index for pagination (0-based).","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_305"},"schema_306":{"kind":"json-schema","data":{"description":"Number of items per page.","type":"integer","minimum":0,"maximum":100},"id":"schema_306"},"schema_307":{"kind":"json-schema","data":{"type":"string","enum":["ascAmount","descAmount"]},"id":"schema_307"},"schema_308":{"kind":"json-schema","data":{"type":"object","properties":{"count":{"type":"number","description":"Total number of transactions matching the query (before pagination)."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Transaction ID."},"accountId":{"type":"number","description":"Account ID."},"name":{"description":"Contact or transaction name.","nullable":true,"type":"string"},"email":{"description":"Contact or transaction email.","nullable":true,"type":"string"},"phoneNumber":{"description":"Contact or transaction phone number.","nullable":true,"type":"string"},"description":{"description":"Transaction description.","nullable":true,"type":"string"},"value":{"type":"number","description":"Transaction value."},"currency":{"description":"ISO 4217 alpha code (e.g. USD, EUR, GBP, JPY); null if not set.","nullable":true,"type":"string"},"source":{"description":"Source of the transaction (e.g. \"Zapier\").","nullable":true,"type":"string"},"updatedBy":{"description":"Identifier of who last updated.","nullable":true,"type":"string"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Creation time (ISO 8601 when serialized)."},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Last update time (ISO 8601 when serialized)."},"syncedDeal":{"description":"Deal ID when synced to a deal; null Otherwise.","nullable":true,"type":"number"},"deal":{"nullable":true,"description":"Present when transaction is synced to a deal; null Otherwise. Includes contact when populated.","type":"object","properties":{"contact":{"description":"Deal contact when populated.","type":"object","properties":{"id":{"type":"number","description":"Contact ID."},"firstName":{"description":"Contact first name.","nullable":true,"type":"string"},"lastName":{"description":"Contact last name.","nullable":true,"type":"string"},"email":{"description":"Contact email.","nullable":true,"type":"string"},"previewId":{"description":"Contact preview identifier."}},"required":["id"],"additionalProperties":false}},"additionalProperties":false}},"required":["id","accountId","value","createdAt","updatedAt","deal"],"additionalProperties":false},"description":"Page of transaction items."}},"required":["count","data"],"additionalProperties":false},"id":"schema_308"},"schema_309":{"kind":"json-schema","data":{"type":"object","properties":{"name":{"description":"Contact or transaction name.","type":"string"},"email":{"type":"string","maxLength":255,"format":"email"},"phoneNumber":{"type":"string","maxLength":16,"pattern":"^\\+?[1-9]\\d{1,14}$"},"description":{"description":"Transaction description (max 1000 chars).","type":"string","maxLength":1000},"value":{"type":"number","description":"Transaction value (required)."},"source":{"description":"Source of the transaction (e.g. \"Zapier\").","type":"string","enum":["Zapier","Stripe","Make","Other"]},"updatedBy":{"description":"Identifier of who is creating/updating.","type":"string"}},"required":["value"],"additionalProperties":false,"example":{"name":"John Doe","phoneNumber":"+15551234567","description":"Test transaction","email":"user@example.com","value":0,"source":"Zapier"}},"id":"schema_309"},"schema_310":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Top-level. Present on success. Localized success message (e.g. \"Transaction added successfully\").","type":"string"},"status":{"description":"Top-level. Present on success. HTTP-style status code (e.g. 200).","type":"number"},"data":{"description":"Top-level. Present on success. Contains the created transaction.","type":"object","properties":{"transaction":{"type":"object","properties":{"id":{"type":"number","description":"Transaction ID."},"accountId":{"type":"number","description":"Account ID."},"syncedDeal":{"description":"Deal ID when transaction is synced to a deal; null or omitted Other wise.","nullable":true,"type":"number"},"name":{"description":"Contact or transaction name.","nullable":true,"type":"string"},"email":{"description":"Contact or transaction email.","nullable":true,"type":"string"},"phoneNumber":{"description":"Contact or transaction phone number.","nullable":true,"type":"string"},"description":{"description":"Transaction description (max 1000 chars).","nullable":true,"type":"string"},"value":{"anyOf":[{"type":"number"},{"type":"string"}],"description":"Transaction value. May be string as a number when serialized."},"currency":{"description":"ISO 4217 alpha code (e.g. USD, EUR, GBP, JPY); null if not set.","nullable":true,"type":"string"},"source":{"description":"Source of the transaction (e.g. \"Zapier\").","nullable":true,"type":"string","enum":["Zapier","Stripe","Make","Other"]},"updatedBy":{"description":"Identifier of who last updated the transaction.","nullable":true,"type":"string"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Creation time (ISO 8601 when serialized)."},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Last update time (ISO 8601 when serialized)."},"deletedAt":{"description":"Soft-delete time; null when not deleted.","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]}},"required":["id","accountId","value","createdAt","updatedAt"],"additionalProperties":false}},"required":["transaction"],"additionalProperties":false}},"additionalProperties":false,"description":"Create response: top-level keys are message (string), status (number), and data (object with transaction). Message and status are present on success."},"id":"schema_310"},"schema_311":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Transaction ID to update (required)."},"name":{"description":"Contact or transaction name.","type":"string"},"email":{"type":"string","maxLength":255,"format":"email"},"phoneNumber":{"type":"string","maxLength":16,"pattern":"^\\+?[1-9]\\d{1,14}$"},"description":{"description":"Transaction description (max 1000 chars).","type":"string","maxLength":1000},"value":{"description":"Transaction value.","type":"number"},"source":{"description":"Source of the transaction (e.g. \"Zapier\").","type":"string","enum":["Zapier","Stripe","Make","Other"]}},"required":["id"],"additionalProperties":false,"example":{"id":1,"name":"John Doe","phoneNumber":"+15551234567","description":"Test transaction","email":"user@example.com","value":0,"source":"Zapier"}},"id":"schema_311"},"schema_312":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Top-level. Present on success. Localized success message (e.g. \"Transaction updated successfully\").","type":"string"},"status":{"description":"Top-level. Present on success. HTTP-style status code (e.g. 200).","type":"number"},"data":{"description":"Top-level. Present on success. Contains the updated transaction.","type":"object","properties":{"transaction":{"type":"object","properties":{"id":{"type":"number","description":"Transaction ID."},"accountId":{"type":"number","description":"Account ID."},"syncedDeal":{"description":"Deal ID when transaction is synced to a deal; null or omitted Other wise.","nullable":true,"type":"number"},"name":{"description":"Contact or transaction name.","nullable":true,"type":"string"},"email":{"description":"Contact or transaction email.","nullable":true,"type":"string"},"phoneNumber":{"description":"Contact or transaction phone number.","nullable":true,"type":"string"},"description":{"description":"Transaction description (max 1000 chars).","nullable":true,"type":"string"},"value":{"anyOf":[{"type":"number"},{"type":"string"}],"description":"Transaction value. May be string as a number when serialized."},"currency":{"description":"ISO 4217 alpha code (e.g. USD, EUR, GBP, JPY); null if not set.","nullable":true,"type":"string"},"source":{"description":"Source of the transaction (e.g. \"Zapier\").","nullable":true,"type":"string","enum":["Zapier","Stripe","Make","Other"]},"updatedBy":{"description":"Identifier of who last updated the transaction.","nullable":true,"type":"string"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Creation time (ISO 8601 when serialized)."},"updatedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Last update time (ISO 8601 when serialized)."},"deletedAt":{"description":"Soft-delete time; null when not deleted.","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]}},"required":["id","accountId","value","createdAt","updatedAt"],"additionalProperties":false}},"required":["transaction"],"additionalProperties":false}},"additionalProperties":false,"description":"Update response: top-level keys are message (string), status (number), and data (object with transaction). Message and status are present on success."},"id":"schema_312"},"schema_313":{"kind":"json-schema","data":{"type":"integer"},"id":"schema_313"},"schema_314":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"description":"Present on success. Localized success message (e.g. \"Transaction deleted successfully\").","type":"string"},"status":{"description":"Present on success. HTTP-style status code (e.g. 200).","type":"number"}},"additionalProperties":false},"id":"schema_314"},"schema_315":{"kind":"json-schema","data":{"description":"Optional user ID to return availabilities for a specific user.","type":"integer","exclusiveMinimum":true,"maximum":2147483647,"minimum":0},"id":"schema_315"},"schema_316":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"User availability id."},"userId":{"type":"number","description":"Owner user ID."},"name":{"type":"string","description":"Availability name."},"timeZone":{"type":"string","description":"IANA time zone for this availability schedule."},"isDefault":{"type":"boolean","description":"Whether this is the default availability for the user."},"createdAt":{"description":"Timestamp when the availability was created.","anyOf":[{"type":"string","format":"date-time"},{"type":"string"}]},"userAvailabilityDays":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Availability day id."},"name":{"type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"],"description":"Weekday name for this day entry."},"active":{"type":"boolean","description":"Whether at least one timing slot exists for this weekday."},"timings":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","description":"Start time in HH:mm format in the availability time zone."},"endTime":{"type":"string","description":"End time in HH:mm format in the availability time zone."}},"required":["startTime","endTime"],"additionalProperties":false},"description":"Timing slots for this weekday (can be empty)."}},"required":["id","name","active","timings"],"additionalProperties":false},"description":"Weekday availability matrix for the schedule."},"eventId":{"type":"array","items":{"type":"number"},"description":"Event IDs currently associated with this availability."}},"required":["id","userId","name","timeZone","isDefault","userAvailabilityDays","eventId"],"additionalProperties":false},"description":"List of availability schedules matching the request filter."}},"required":["data"],"additionalProperties":false},"id":"schema_316"},"schema_317":{"kind":"json-schema","data":{"default":20,"description":"Number of users per page. Default is 20; maximum is 100.","type":"integer","minimum":1,"maximum":100},"id":"schema_317"},"schema_318":{"kind":"json-schema","data":{"default":0,"description":"Zero-based page index.","type":"integer","minimum":0,"maximum":2147483647},"id":"schema_318"},"schema_319":{"kind":"json-schema","data":{"description":"Optional text query that matches user name and email fields.","type":"string"},"id":"schema_319"},"schema_320":{"kind":"json-schema","data":{"description":"Optional comma-separated user IDs to include in results.","type":"string"},"id":"schema_320"},"schema_321":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"User id."},"firstName":{"type":"string","description":"User first name."},"lastName":{"nullable":true,"description":"User last name; null when not set.","type":"string"},"email":{"type":"string","description":"User email address."},"phoneNumber":{"nullable":true,"description":"User phone number; null when not set.","type":"string"},"timeZone":{"nullable":true,"description":"User IANA time zone; null when not set.","type":"string"},"createdAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"}],"description":"Timestamp when the user was created (ISO 8601)."},"deletedAt":{"description":"Timestamp when the user was soft-deleted; null when active.","anyOf":[{"type":"string","format":"date-time","nullable":true},{"type":"string","nullable":true}]},"role":{"nullable":true,"description":"Account role assigned to the user.","type":"string"},"integrations":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["googleCalendar","zoom"],"description":"Integration provider name. Currently one of googleCalendar or zoom."},"platform_id":{"type":"string","description":"Provider-specific account identifier for the integration."}},"required":["name","platform_id"],"additionalProperties":false},"description":"Connected integrations for the user."}},"required":["id","firstName","lastName","email","phoneNumber","timeZone","createdAt","deletedAt","role","integrations"],"additionalProperties":false},"description":"Users returned for the requested page and filters."},"count":{"type":"number","description":"Total number of users matching the filters (before pagination)."}},"required":["users","count"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"id":"schema_321"}},"exampleStore":{"paths/~1v1~1contacts/get/responses/200/content/application~1json/example":{"value":{"data":{"count":1,"contacts":[{"id":2,"email":"jane.doe@example.com","firstName":"Jane","lastName":"Doe","status":"STRATEGY_CALL_BOOKED","phoneNumber":"+15551234567","secondary_email":null,"secondary_phoneNumber":null,"previewId":"contact_examplePreviewId","blockedId":null,"country":null,"timeZone":"America/New_York","createdAt":"12/10/2025","ContactEvents":[{"id":2,"name":"Phone Call"}],"user":{"id":5,"firstName":"Alex","lastName":"Closer","email":"closer@example.com"}}]}},"id":"paths/~1v1~1contacts/get/responses/200/content/application~1json/example"},"paths/~1v1~1contacts/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1contacts/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1contacts/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1contacts/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1contacts/get/responses/403/content/application~1json/example"},"paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1contacts/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1contacts/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1contacts/get/responses/429/content/application~1json/example"},"paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1contacts/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1contacts/post/requestBody/content/application~1json/example":{"value":{"firstName":"Jane","lastName":"Doe","email":"jane.doe@example.com","phoneNumber":"+15551234567","status":"POTENTIAL","tag":"lead-2024","joinedTime":"2024-01-15T10:00:00.000Z","linkPrefix":"product-demo","utm":"utm_source=google&utm_medium=cpc","country":"US","timeZone":"America/New_York","ipAddress":"192.168.1.1","referrerUrl":"https://example.com/signup"},"id":"paths/~1v1~1contacts/post/requestBody/content/application~1json/example"},"paths/~1v1~1contacts/post/responses/201/content/application~1json/example":{"value":{"data":{"contact":{"id":139,"accountId":4,"userId":null,"email":"jane.doe.updated@example.com","firstName":"Jane","lastName":"Doe","status":"QUALIFIED","phoneNumber":"+15551234567","previewId":"contact_exampleUpdatedId","tagId":7,"blockedByRecaptcha":false,"joinedTime":"2026-03-04T20:38:06.409Z","country":"US","timeZone":"America/New_York","blockedId":null,"referrerUrl":"https://example.com/referral","createdAt":"2026-03-04T20:38:06.410Z","updatedAt":"2026-03-05T09:41:22.614Z","deletedAt":null}}},"id":"paths/~1v1~1contacts/post/responses/201/content/application~1json/example"},"paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1contacts/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1contacts/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1contacts/post/responses/403/content/application~1json/example"},"paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1contacts/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1contacts/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1contacts/post/responses/429/content/application~1json/example"},"paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1contacts/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1contacts/put/requestBody/content/application~1json/example":{"value":{"id":123,"firstName":"Jane","lastName":"Doe","email":"jane.doe.updated@example.com","secondary_email":"jane.secondary@example.com","phoneNumber":"+15559876543","secondary_phoneNumber":"+15551112222","status":"QUALIFIED","referrerUrl":"https://example.com/referral"},"id":"paths/~1v1~1contacts/put/requestBody/content/application~1json/example"},"paths/~1v1~1contacts/put/responses/200/content/application~1json/example":{"value":{"data":{"contact":{"id":139,"accountId":4,"userId":null,"email":"jane.doe.updated@example.com","firstName":"Jane","lastName":"Doe","status":"QUALIFIED","phoneNumber":"+15551234567","previewId":"contact_exampleUpdatedId","tagId":7,"blockedByRecaptcha":false,"joinedTime":"2026-03-04T20:38:06.409Z","country":"US","timeZone":"America/New_York","blockedId":null,"referrerUrl":"https://example.com/referral","createdAt":"2026-03-04T20:38:06.410Z","updatedAt":"2026-03-05T09:41:22.614Z","deletedAt":null}}},"id":"paths/~1v1~1contacts/put/responses/200/content/application~1json/example"},"paths/~1v1~1contacts/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1contacts/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1contacts/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1contacts/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1contacts/put/responses/403/content/application~1json/example"},"paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1contacts/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1contacts/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1contacts/put/responses/429/content/application~1json/example"},"paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1contacts/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1contacts~1detail/get/responses/200/content/application~1json/example":{"value":{"data":{"id":2,"firstName":"Jane","lastName":"Doe","email":"jane.doe@example.com","phoneNumber":"+15551234567","secondary_email":null,"secondary_phoneNumber":null,"status":"STRATEGY_CALL_BOOKED","joinedTime":"2025-12-10T10:08:28.566Z","createdAt":"2025-12-10T10:08:28.568Z","updatedAt":"2025-12-26T11:44:32.799Z","referrerUrl":"https://example.com/e/company/phone-call","previewId":"contact_examplePreviewId","timeZone":"America/New_York","user":{"id":5,"firstName":"Alex","lastName":"Closer","email":"closer@example.com"},"ContactEvents":[{"id":2,"name":"Phone Call","location":"PHONE_CALL","color":"#0099FF"}],"ContactStats":{"initialStatus":"QUALIFIED","statusUpdatedAt":"2025-12-26T11:44:32.796Z","lastInteractionStatus":"NEW_CONTACT_NOTE","lastInteractionType":"NEW_CONTACT_NOTE","totalCallsBooked":3,"strategyCallsBooked":3,"discoveryCallsBooked":0,"income":223},"pastCallsCount":3,"upcomingCallsCount":0,"utms":[{"eventCallId":54,"utmKey":"utm_source","utmValue":"google"},{"eventCallId":54,"utmKey":"utm_medium","utmValue":"cpc"}],"CustomFieldAssociation":[{"customField":{"id":248,"name":"Set by","type":"CALL","inputType":"USER","identifier":"set_by"},"CustomFieldAnswer":[{"inputType":"USER","answer":null,"date":null,"number":null,"customFieldOptionId":null,"user":{"id":5,"firstName":"Alex","lastName":"Closer"}}]},{"customField":{"id":11,"name":"Number","type":"CONTACT","inputType":"NUMBER","identifier":"number-1"},"CustomFieldAnswer":[{"inputType":"NUMBER","answer":null,"date":null,"number":3434,"customFieldOptionId":null,"user":null}]},{"customField":{"id":243,"name":"Objection","type":"CALL","inputType":"SINGLE_SELECT","identifier":"objection"},"CustomFieldAnswer":[{"inputType":"SINGLE_SELECT","answer":"MONEY","date":null,"number":null,"customFieldOptionId":283,"user":null}]}]}},"id":"paths/~1v1~1contacts~1detail/get/responses/200/content/application~1json/example"},"paths/~1v1~1contacts~1detail/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1contacts~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1contacts~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1contacts~1detail/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1contacts~1detail/get/responses/403/content/application~1json/example"},"paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1contacts~1detail/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1contacts~1detail/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1contacts~1detail/get/responses/429/content/application~1json/example"},"paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1contacts~1detail/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1contacts~1notes/get/responses/200/content/application~1json/example":{"value":{"count":2,"data":[{"id":101,"text":"Follow-up call scheduled for next week.","createdAt":"2026-04-01T10:00:00.000Z","updatedAt":"2026-04-01T10:00:00.000Z","type":"NOTE","user":{"firstName":"Alex","lastName":"Closer"}},{"id":102,"text":"Sent pricing deck.","createdAt":"2026-04-02T14:30:00.000Z","updatedAt":"2026-04-02T14:30:00.000Z","type":"NOTE","user":{"firstName":"Alex","lastName":"Closer"}}]},"id":"paths/~1v1~1contacts~1notes/get/responses/200/content/application~1json/example"},"paths/~1v1~1contacts~1notes/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1contacts~1notes/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1contacts~1notes/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1contacts~1notes/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1contacts~1notes/get/responses/403/content/application~1json/example"},"paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1contacts~1notes/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1contacts~1notes/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1contacts~1notes/get/responses/429/content/application~1json/example"},"paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1contacts~1notes/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1contacts~1notes/post/requestBody/content/application~1json/example":{"value":{"contactId":2,"note":"Follow-up call scheduled for next week."},"id":"paths/~1v1~1contacts~1notes/post/requestBody/content/application~1json/example"},"paths/~1v1~1contacts~1notes/post/responses/201/content/application~1json/example":{"value":{"message":"Note created successfully","status":201},"id":"paths/~1v1~1contacts~1notes/post/responses/201/content/application~1json/example"},"paths/~1v1~1contacts~1notes/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1contacts~1notes/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1contacts~1notes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1contacts~1notes/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1contacts~1notes/post/responses/403/content/application~1json/example"},"paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1contacts~1notes/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1contacts~1notes/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1contacts~1notes/post/responses/429/content/application~1json/example"},"paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1contacts~1notes/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1deals/get/responses/200/content/application~1json/example":{"value":{"data":{"count":6,"deals":[{"id":1,"productId":1,"contactId":2,"eventCallId":5,"userId":5,"value":100,"time":"2025-12-10 19:23:01.299","recurring":false,"transactionType":"WON","createdAt":"2025-12-10 19:23:40.076","updatedAt":"2025-12-10 19:23:40.076","user":{"id":5,"firstName":"Alex","lastName":"Closer","email":"closer@example.com"},"event":{"name":"Email Only","color":"#0099FF","eventType":"STRATEGY_EVENT"},"contact":{"id":2,"firstName":"Jane","lastName":"Doe","email":"jane.doe@example.com","phoneNumber":"+15551234567","secondary_email":null,"secondary_phoneNumber":null,"timeZone":"America/New_York","status":"STRATEGY_CALL_BOOKED","joinedTime":"2025-12-10 15:08:54.913","previewId":"contact_examplePreviewId","createdVia":"SCHEDULING_WIDGET","createdAt":"2025-12-10 15:08:54.915","updatedAt":"2025-12-26 16:44:32.799"},"tag":{"id":2,"name":"mobile"},"product":{"id":1,"name":"Mobile","createdAt":"2025-12-10T10:57:41.205Z"}}]}},"id":"paths/~1v1~1deals/get/responses/200/content/application~1json/example"},"paths/~1v1~1deals/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1deals/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1deals/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1deals/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1deals/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1deals/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1deals/get/responses/403/content/application~1json/example"},"paths/~1v1~1deals/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1deals/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1deals/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1deals/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1deals/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1deals/get/responses/429/content/application~1json/example"},"paths/~1v1~1deals/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1deals/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1deals/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1deals/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1deals/post/requestBody/content/application~1json/example":{"value":{"eventCallId":5,"productId":1,"value":100,"time":"2026-06-15T15:00:00.000Z","transactionType":"WON"},"id":"paths/~1v1~1deals/post/requestBody/content/application~1json/example"},"paths/~1v1~1deals/post/responses/201/content/application~1json/example":{"value":{"data":{"id":1,"productId":1,"contactId":1,"eventCallId":1,"userId":1,"tagId":1,"value":100,"time":"2026-03-05T10:21:59.645Z","recurring":false,"transactionType":"WON","createdAt":"2026-03-05T10:25:17.249Z","updatedAt":"2026-03-05T10:25:17.249Z","product":{"name":"Mobile"},"eventCall":{"id":1,"userId":1,"eventId":1,"previewId":"call_examplePreviewId","callType":"STRATEGY_EVENT","dateTime":"2025-12-16T05:45:00.000Z","user":{"id":1,"firstName":"Alex","lastName":"Closer","email":"closer@example.com","phoneNumber":null},"contact":{"id":1,"firstName":"Jane","lastName":"Doe","email":"jane.doe@example.com","phoneNumber":"+15551234567"},"event":{"id":1,"eventType":"STRATEGY_EVENT","name":"Phone Call","color":"#0099FF","duration":30,"durationUnit":"MINUTES"}},"transaction":[]}},"id":"paths/~1v1~1deals/post/responses/201/content/application~1json/example"},"paths/~1v1~1deals/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1deals/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1deals/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1deals/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1deals/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1deals/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1deals/post/responses/403/content/application~1json/example"},"paths/~1v1~1deals/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1deals/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1deals/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1deals/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1deals/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1deals/post/responses/429/content/application~1json/example"},"paths/~1v1~1deals/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1deals/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1deals/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1deals/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1deals/put/requestBody/content/application~1json/example":{"value":{"id":1,"value":150,"recurring":false,"transactionType":"WON"},"id":"paths/~1v1~1deals/put/requestBody/content/application~1json/example"},"paths/~1v1~1deals/put/responses/200/content/application~1json/example":{"value":{"data":{"id":1,"productId":1,"contactId":1,"eventCallId":1,"userId":1,"tagId":1,"value":100,"time":"2026-03-05T10:21:59.645Z","recurring":false,"transactionType":"WON","createdAt":"2026-03-05T10:25:17.249Z","updatedAt":"2026-03-05T10:25:17.249Z","product":{"name":"Mobile"},"eventCall":{"id":1,"userId":1,"eventId":1,"previewId":"call_examplePreviewId","callType":"STRATEGY_EVENT","dateTime":"2025-12-16T05:45:00.000Z","user":{"id":1,"firstName":"Alex","lastName":"Closer","email":"closer@example.com","phoneNumber":null},"contact":{"id":1,"firstName":"Jane","lastName":"Doe","email":"jane.doe@example.com","phoneNumber":"+15551234567"},"event":{"id":1,"eventType":"STRATEGY_EVENT","name":"Phone Call","color":"#0099FF","duration":30,"durationUnit":"MINUTES"}},"transaction":[]}},"id":"paths/~1v1~1deals/put/responses/200/content/application~1json/example"},"paths/~1v1~1deals/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1deals/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1deals/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1deals/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1deals/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1deals/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1deals/put/responses/403/content/application~1json/example"},"paths/~1v1~1deals/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1deals/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1deals/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1deals/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1deals/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1deals/put/responses/429/content/application~1json/example"},"paths/~1v1~1deals/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1deals/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1deals/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1deals/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1events/get/responses/200/content/application~1json/example":{"value":{"count":2,"totalCount":2,"hasVisibleEvents":true,"data":[{"id":1,"userId":101,"duration":15,"durationUnit":"MINUTES","location":"GOOGLE_MEET","dateRangeType":"DEFINITE","dateRangeUnit":"CALENDAR_DAYS","linkPrefix":"company/discovery-call","status":"ACTIVATED","allowReschedule":true,"phonePreferred":true,"splitFullName":true,"businessEmail":false,"disableDuplicateBooking":false,"lockHostOnReschedule":false,"dateRangeDays":13,"bypassQuestion":false},{"id":2,"name":"Discovery Call","color":"#0099FF","eventType":"STRATEGY_EVENT","description":"<p>Introductory call for new leads.</p>","internalDescription":"Introductory call for new leads.","deletedAt":null,"language":"ENGLISH","emailValidationEnabled":true,"phoneNumberValidationEnabled":true,"creditCheck":{"type":"CREDIT_CHECK_DTI_RATIO","toggle":true},"userId":101,"duration":15,"durationUnit":"MINUTES","location":"GOOGLE_MEET","dateRangeType":"DEFINITE","dateRangeUnit":"CALENDAR_DAYS","linkPrefix":"company/phone-call","status":"ACTIVATED","allowReschedule":true,"phonePreferred":false,"splitFullName":true,"businessEmail":false,"disableDuplicateBooking":false,"lockHostOnReschedule":false,"dateRangeDays":14,"bypassQuestion":false}]},"id":"paths/~1v1~1events/get/responses/200/content/application~1json/example"},"paths/~1v1~1events/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1events/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1events/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1events/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1events/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1events/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1events/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1events/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1events/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1events/get/responses/403/content/application~1json/example"},"paths/~1v1~1events/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1events/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1events/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1events/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1events/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1events/get/responses/429/content/application~1json/example"},"paths/~1v1~1events/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1events/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1events/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1events/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1events~1detail/get/responses/200/content/application~1json/example":{"value":{"data":{"id":4,"linkPrefix":"company/discovery-call","name":"new-event","color":"#0099FF","eventType":"STRATEGY_EVENT","status":"ACTIVATED","userId":2,"duration":30,"durationUnit":"MINUTES","location":"PHONE_CALL","allowReschedule":true,"phonePreferred":true,"splitFullName":true,"dateRangeType":"DEFINITE","dateRangeUnit":"CALENDAR_DAYS","dateRangeDays":14}},"id":"paths/~1v1~1events~1detail/get/responses/200/content/application~1json/example"},"paths/~1v1~1events~1detail/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1events~1detail/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1events~1detail/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1events~1detail/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1events~1detail/get/responses/403/content/application~1json/example"},"paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1events~1detail/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1events~1detail/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1events~1detail/get/responses/429/content/application~1json/example"},"paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1events~1detail/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1events~1status/put/requestBody/content/application~1json/example":{"value":{"id":4,"status":"ACTIVATED"},"id":"paths/~1v1~1events~1status/put/requestBody/content/application~1json/example"},"paths/~1v1~1events~1status/put/responses/200/content/application~1json/example":{"value":{"message":"Event status updated successfully","status":200},"id":"paths/~1v1~1events~1status/put/responses/200/content/application~1json/example"},"paths/~1v1~1events~1status/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1events~1status/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1events~1status/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1events~1status/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1events~1status/put/responses/403/content/application~1json/example"},"paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1events~1status/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1events~1status/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1events~1status/put/responses/429/content/application~1json/example"},"paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1events~1status/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1events~1troubleshootSlots/get/responses/200/content/application~1json/example":{"value":{"data":{"slots":[{"slot":"09:45 AM","tags":["Time range is in past"],"reason":"This time slot is in past.","availableUsers":[],"unAvailableUsers":[{"id":101,"firstName":"Alex","lastName":"Closer","profilePictureKey":"closer@example.com/profile","inviteNotAccepted":false,"signedUrl":"https://example.com/assets/closer@example.com/profile"}],"datetime":"1773135900000"},{"slot":"03:45 PM","tags":[],"reason":null,"availableUsers":[{"id":101,"firstName":"Alex","lastName":"Closer","email":"closer@example.com","phoneNumber":"+15551234567","profilePictureKey":"closer@example.com/profile","signedUrl":"https://example.com/assets/closer@example.com/profile","extraDetails":null}],"unAvailableUsers":[],"datetime":"1773157500000"}],"noOfAvailableSlots":11}},"id":"paths/~1v1~1events~1troubleshootSlots/get/responses/200/content/application~1json/example"},"paths/~1v1~1events~1troubleshootSlots/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1events~1troubleshootSlots/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1events~1troubleshootSlots/get/responses/403/content/application~1json/example"},"paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1events~1troubleshootSlots/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1events~1troubleshootSlots/get/responses/429/content/application~1json/example"},"paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1events~1troubleshootSlots/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1events~1eventDates/post/requestBody/content/application~1json/example":{"value":{"linkPrefix":"company/discovery-call","timeZone":"America/New_York","currentDate":"2026-04-15","conditionalUsers":"101,102","routingGroupIds":"10"},"id":"paths/~1v1~1events~1eventDates/post/requestBody/content/application~1json/example"},"paths/~1v1~1events~1eventDates/post/responses/201/content/application~1json/example":{"value":{"data":{"isPreview":false,"availabilities":{"2026-02-26":["09:00","09:15","10:00"],"2026-02-27":["09:00","14:00"]},"appliedHostIds":[101,102,103]}},"id":"paths/~1v1~1events~1eventDates/post/responses/201/content/application~1json/example"},"paths/~1v1~1events~1eventDates/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1events~1eventDates/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1events~1eventDates/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1events~1eventDates/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1events~1eventDates/post/responses/403/content/application~1json/example"},"paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1events~1eventDates/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1events~1eventDates/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1events~1eventDates/post/responses/429/content/application~1json/example"},"paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1events~1eventDates/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1products/get/responses/200/content/application~1json/example":{"value":{"data":{"count":3,"products":[{"id":3,"tagId":9,"name":"Laptop2","description":"","createdAt":"2026-03-04T21:28:18.027Z","updatedAt":"2026-03-04T21:28:18.027Z","tag":{"id":9,"name":"laptop2","createdAt":"2026-03-04T21:28:18.029Z"},"_count":{"deals":0}},{"id":4,"tagId":10,"name":"testset","description":"","createdAt":"2026-03-05T10:37:28.306Z","updatedAt":"2026-03-05T10:37:28.306Z","tag":{"id":10,"name":"testset","createdAt":"2026-03-05T10:37:28.307Z"},"_count":{"deals":0}},{"id":5,"tagId":11,"name":"Phone","description":"","createdAt":"2026-03-05T12:00:00.000Z","updatedAt":"2026-03-05T12:00:00.000Z","tag":{"id":11,"name":"phone","createdAt":"2026-03-05T12:00:00.010Z"},"_count":{"deals":0}}]}},"id":"paths/~1v1~1products/get/responses/200/content/application~1json/example"},"paths/~1v1~1products/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1products/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1products/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1products/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1products/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1products/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1products/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1products/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1products/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1products/get/responses/403/content/application~1json/example"},"paths/~1v1~1products/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1products/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1products/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1products/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1products/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1products/get/responses/429/content/application~1json/example"},"paths/~1v1~1products/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1products/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1products/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1products/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1products/post/requestBody/content/application~1json/example":{"value":{"name":"Premium Plan","description":"Annual subscription tier"},"id":"paths/~1v1~1products/post/requestBody/content/application~1json/example"},"paths/~1v1~1products/post/responses/201/content/application~1json/example":{"value":{"data":{"product":{"id":4,"tagId":10,"name":"testset","createdAt":"2026-03-05T10:37:28.306Z","updatedAt":"2026-03-05T10:37:28.306Z"}}},"id":"paths/~1v1~1products/post/responses/201/content/application~1json/example"},"paths/~1v1~1products/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1products/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1products/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1products/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1products/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1products/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1products/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1products/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1products/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1products/post/responses/403/content/application~1json/example"},"paths/~1v1~1products/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1products/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1products/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1products/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1products/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1products/post/responses/429/content/application~1json/example"},"paths/~1v1~1products/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1products/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1products/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1products/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1products/put/requestBody/content/application~1json/example":{"value":{"productId":4,"name":"Premium Plan","description":"Updated product description"},"id":"paths/~1v1~1products/put/requestBody/content/application~1json/example"},"paths/~1v1~1products/put/responses/200/content/application~1json/example":{"value":{"data":{"product":{"id":4,"tagId":10,"name":"testset","createdAt":"2026-03-05T10:37:28.306Z","updatedAt":"2026-03-05T10:37:28.306Z"}}},"id":"paths/~1v1~1products/put/responses/200/content/application~1json/example"},"paths/~1v1~1products/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1products/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1products/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1products/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1products/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1products/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1products/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1products/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1products/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1products/put/responses/403/content/application~1json/example"},"paths/~1v1~1products/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1products/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1products/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1products/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1products/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1products/put/responses/429/content/application~1json/example"},"paths/~1v1~1products/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1products/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1products/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1products/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealManual":{"value":{"eventCallId":1001,"outcome":"WON","objection":"NO_OBJECTION","notes":"Closed on first strategy call.","newDeal":{"value":5000,"transactionType":"WON","productId":42,"date":"2026-04-10T15:30:00.000Z"}},"key":"strategyWonNewDealManual","summary":"Strategy call — WON with newDeal (manual value)","id":"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealManual"},"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealFromTransactions":{"value":{"eventCallId":1002,"outcome":"WON","objection":"MONEY","newDeal":{"productId":42,"transactionIds":[90001,90002]}},"key":"strategyWonNewDealFromTransactions","summary":"Strategy call — WON with newDeal.transactionIds","id":"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyWonNewDealFromTransactions"},"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleWithReason":{"value":{"eventCallId":1004,"outcome":"NO_SALE","noSaleReason":"NO_SHOW","notes":"Contact did not join."},"key":"strategyNoSaleWithReason","summary":"Strategy call — NO_SALE with noSaleReason (no objection)","id":"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleWithReason"},"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleFollowUpWithObjection":{"value":{"eventCallId":1005,"outcome":"NO_SALE","noSaleReason":"FOLLOW_UP_SCHEDULE","objection":"LOGISTIC","notes":"Follow-up booked; logistics concern."},"key":"strategyNoSaleFollowUpWithObjection","summary":"Strategy call — NO_SALE FOLLOW_UP_SCHEDULE with objection","id":"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/strategyNoSaleFollowUpWithObjection"},"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryApprovedWithObjection":{"value":{"eventCallId":2001,"outcome":"APPROVED","objection":"NO_OBJECTION","notes":"Qualified for strategy call."},"key":"discoveryApprovedWithObjection","summary":"Discovery call — APPROVED (optional objection)","id":"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryApprovedWithObjection"},"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryRejectedBadFit":{"value":{"eventCallId":2002,"outcome":"REJECTED","noSaleReason":"BAD_FIT","notes":"Not a fit for the offer."},"key":"discoveryRejectedBadFit","summary":"Discovery call — REJECTED with BAD_FIT","id":"paths/~1v1~1outcomes/post/requestBody/content/application~1json/examples/discoveryRejectedBadFit"},"paths/~1v1~1outcomes/post/responses/200/content/application~1json/example":{"value":{"data":{"id":6,"noSaleReason":null,"objection":"NO_OBJECTION","updatedAt":"2026-04-13T12:00:00.000Z"}},"id":"paths/~1v1~1outcomes/post/responses/200/content/application~1json/example"},"paths/~1v1~1outcomes/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1outcomes/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1outcomes/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1outcomes/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1outcomes/post/responses/403/content/application~1json/example"},"paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1outcomes/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1outcomes/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1outcomes/post/responses/429/content/application~1json/example"},"paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1outcomes/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields/post/requestBody/content/application~1json/example":{"value":{"name":"Lead source","identifier":"lead-source","description":"Where the lead originated","inputType":"SINGLE_SELECT","type":"CONTACT","configuration":{"isColorCodeOptions":true},"options":[{"name":"Inbound","color":"blue","displayIndex":0},{"name":"Outbound","color":"gray","displayIndex":1}]},"id":"paths/~1v1~1fields/post/requestBody/content/application~1json/example"},"paths/~1v1~1fields/post/responses/201/content/application~1json/example":{"value":{"message":"Custom Fields created successfully","status":201,"data":{"id":20660,"associationCount":0,"name":"mult select","identifier":"mult-select","description":"","inputType":"MULTIPLE_SELECT","type":"CONTACT","subType":null,"isSecondaryQuestion":false,"isSystemField":false,"hidden":false,"configuration":{"isColorCodeOptions":true},"createdAt":"2026-03-05T10:00:17.711Z","updatedAt":"2026-03-05T10:00:17.711Z","CustomFieldOptions":[{"id":90157,"color":"blue","name":"1","displayIndex":0,"isArchived":false,"createdAt":"2026-03-05T10:00:17.792Z","updatedAt":"2026-03-05T10:00:17.792Z"},{"id":90158,"color":"blue","name":"2","displayIndex":1,"isArchived":false,"createdAt":"2026-03-05T10:00:17.830Z","updatedAt":"2026-03-05T10:00:17.830Z"}]}},"id":"paths/~1v1~1fields/post/responses/201/content/application~1json/example"},"paths/~1v1~1fields/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields/post/responses/403/content/application~1json/example"},"paths/~1v1~1fields/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields/post/responses/429/content/application~1json/example"},"paths/~1v1~1fields/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields/put/requestBody/content/application~1json/example":{"value":{"id":20660,"name":"Lead source","identifier":"lead-source","description":"Where the lead originated","configuration":{"isColorCodeOptions":true},"options":[{"name":"Inbound","color":"blue","displayIndex":0},{"name":"Outbound","color":"gray","displayIndex":1}],"hidden":false},"id":"paths/~1v1~1fields/put/requestBody/content/application~1json/example"},"paths/~1v1~1fields/put/responses/200/content/application~1json/example":{"value":{"message":"Custom field updated successfully","status":200,"data":{"id":20660,"associationCount":0,"name":"mult select","identifier":"mult-select","description":"","inputType":"MULTIPLE_SELECT","type":"CONTACT","subType":null,"isSecondaryQuestion":false,"isSystemField":false,"hidden":false,"configuration":{"isColorCodeOptions":true},"createdAt":"2026-03-05T10:00:17.711Z","updatedAt":"2026-03-05T10:00:18.000Z","CustomFieldOptions":[{"id":90157,"color":"blue","name":"1","displayIndex":0,"isArchived":false,"createdAt":"2026-03-05T10:00:17.792Z","updatedAt":"2026-03-05T10:00:17.792Z"},{"id":90158,"color":"blue","name":"2","displayIndex":1,"isArchived":false,"createdAt":"2026-03-05T10:00:17.830Z","updatedAt":"2026-03-05T10:00:17.830Z"}]}},"id":"paths/~1v1~1fields/put/responses/200/content/application~1json/example"},"paths/~1v1~1fields/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields/put/responses/403/content/application~1json/example"},"paths/~1v1~1fields/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields/put/responses/429/content/application~1json/example"},"paths/~1v1~1fields/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_NUMBER":{"value":{"customFieldId":22,"contactId":8,"answer":["42"]},"key":"contact_NUMBER","summary":"NUMBER (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_NUMBER"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT":{"value":{"customFieldId":23,"contactId":8,"answer":["Short text value"]},"key":"contact_TEXT","summary":"TEXT (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT_AREA":{"value":{"customFieldId":24,"contactId":8,"answer":["Longer paragraph or multi-line notes."]},"key":"contact_TEXT_AREA","summary":"TEXT_AREA (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_TEXT_AREA"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_DATE":{"value":{"customFieldId":27,"contactId":8,"answer":["2026-04-10"]},"key":"contact_DATE","summary":"DATE (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_DATE"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USER":{"value":{"customFieldId":28,"contactId":8,"answer":["2"]},"key":"contact_USER","summary":"USER (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USER"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USERS_MULTIPLE":{"value":{"customFieldId":29,"contactId":8,"answer":["2"]},"key":"contact_USERS_MULTIPLE","summary":"USERS_MULTIPLE (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_USERS_MULTIPLE"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_URL":{"value":{"customFieldId":26,"contactId":8,"answer":["https://docs.iclosed.io/"]},"key":"contact_URL","summary":"URL (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_URL"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_SINGLE_SELECT":{"value":{"customFieldId":12,"contactId":8,"answer":["Nurturing"]},"key":"contact_SINGLE_SELECT","summary":"SINGLE_SELECT (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_SINGLE_SELECT"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_MULTIPLE_SELECT":{"value":{"customFieldId":42,"contactId":8,"answer":["Newsletter","Webinar"]},"key":"contact_MULTIPLE_SELECT","summary":"MULTIPLE_SELECT (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_MULTIPLE_SELECT"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_EMAIL":{"value":{"customFieldId":25,"contactId":8,"answer":["user@example.com"]},"key":"contact_EMAIL","summary":"EMAIL (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_EMAIL"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_RATING":{"value":{"customFieldId":30,"contactId":8,"answer":["4"]},"key":"contact_RATING","summary":"RATING (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/contact_RATING"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_NUMBER":{"value":{"customFieldId":32,"eventCallId":6,"answer":["42"]},"key":"call_NUMBER","summary":"NUMBER (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_NUMBER"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT":{"value":{"customFieldId":21,"eventCallId":6,"answer":["Call notes"]},"key":"call_TEXT","summary":"TEXT (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT_AREA":{"value":{"customFieldId":33,"eventCallId":6,"answer":["Detailed call summary."]},"key":"call_TEXT_AREA","summary":"TEXT_AREA (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_TEXT_AREA"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_DATE":{"value":{"customFieldId":34,"eventCallId":6,"answer":["2026-04-10T12:00:00.000Z"]},"key":"call_DATE","summary":"DATE (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_DATE"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USER":{"value":{"customFieldId":35,"eventCallId":6,"answer":["2"]},"key":"call_USER","summary":"USER (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USER"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USERS_MULTIPLE":{"value":{"customFieldId":36,"eventCallId":6,"answer":["2"]},"key":"call_USERS_MULTIPLE","summary":"USERS_MULTIPLE (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_USERS_MULTIPLE"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_URL":{"value":{"customFieldId":39,"eventCallId":6,"answer":["https://docs.iclosed.io/"]},"key":"call_URL","summary":"URL (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_URL"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_SINGLE_SELECT":{"value":{"customFieldId":31,"eventCallId":6,"answer":["Completed"]},"key":"call_SINGLE_SELECT","summary":"SINGLE_SELECT (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_SINGLE_SELECT"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_MULTIPLE_SELECT":{"value":{"customFieldId":40,"eventCallId":6,"answer":["Follow up","Hot"]},"key":"call_MULTIPLE_SELECT","summary":"MULTIPLE_SELECT (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_MULTIPLE_SELECT"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_EMAIL":{"value":{"customFieldId":38,"eventCallId":6,"answer":["followup@example.com"]},"key":"call_EMAIL","summary":"EMAIL (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_EMAIL"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_RATING":{"value":{"customFieldId":37,"eventCallId":6,"answer":["5"]},"key":"call_RATING","summary":"RATING (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/call_RATING"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_contact":{"value":{"identifier":"contact_stage","contactId":8,"answer":["Engaged"]},"key":"by_identifier_contact","summary":"By identifier (Contact)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_contact"},"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_call":{"value":{"identifier":"docs-call-outcome","eventCallId":6,"answer":["No show"]},"key":"by_identifier_call","summary":"By identifier (Call)","id":"paths/~1v1~1fields~1answer/post/requestBody/content/application~1json/examples/by_identifier_call"},"paths/~1v1~1fields~1answer/post/responses/201/content/application~1json/example":{"value":{"contactId":8,"createdAt":"2026-04-13T07:15:09.652Z","updatedBy":{"id":2,"firstName":"Alex","lastName":"Closer"},"CustomFieldAnswer":[{"customFieldRelationId":28,"inputType":"NUMBER","answer":null,"number":42,"date":null,"customFieldOptionId":null,"user":null,"userId":null,"createdAt":"2026-04-13T07:15:09.652Z"}],"customField":{"id":22,"name":"Docs Sample Number","inputType":"NUMBER","type":"CONTACT","isSystemField":false,"identifier":"docs-sample-number"},"message":"Custom Fields Answer Created successfully"},"id":"paths/~1v1~1fields~1answer/post/responses/201/content/application~1json/example"},"paths/~1v1~1fields~1answer/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields~1answer/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields~1answer/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields~1answer/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields~1answer/post/responses/403/content/application~1json/example"},"paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields~1answer/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields~1answer/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields~1answer/post/responses/429/content/application~1json/example"},"paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields~1answer/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields~1answer~1bulk/post/requestBody/content/application~1json/examples/contact_TEXT_bulk":{"value":{"customFieldId":23,"contactIds":[8,9,10],"answer":["Short text value"],"overrideExisting":true},"key":"contact_TEXT_bulk","summary":"TEXT (multiple contacts)","id":"paths/~1v1~1fields~1answer~1bulk/post/requestBody/content/application~1json/examples/contact_TEXT_bulk"},"paths/~1v1~1fields~1answer~1bulk/post/responses/201/content/application~1json/example":{"value":{"message":"Custom Fields Answer Created successfully"},"id":"paths/~1v1~1fields~1answer~1bulk/post/responses/201/content/application~1json/example"},"paths/~1v1~1fields~1answer~1bulk/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields~1answer~1bulk/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields~1answer~1bulk/post/responses/403/content/application~1json/example"},"paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields~1answer~1bulk/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields~1answer~1bulk/post/responses/429/content/application~1json/example"},"paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields~1answer~1bulk/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields~1inviteeAnswers/post/requestBody/content/application~1json/example":{"value":{"linkPrefix":"company/discovery-call","contactId":12,"inviteeQuestionAnswers":[{"type":"EMAIL","answer":"jane.doe@example.com"}],"timeZone":"America/New_York","secondaryQuestionsAnswer":[],"publicSessionId":"00000000-0000-4000-8000-000000000001"},"id":"paths/~1v1~1fields~1inviteeAnswers/post/requestBody/content/application~1json/example"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/201/content/application~1json/example":{"value":{"data":{"message":"Questions Answers Inserted Successfully","disqualifyingCondition":[],"conditionalUsers":[101,102],"routingGroupIds":[10],"routingMode":"SPECIFIC_HOSTS_TEAMS","isDisqualified":false}},"id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/201/content/application~1json/example"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/403/content/application~1json/example"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/429/content/application~1json/example"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields~1inviteeAnswers/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields~1contact-stage/get/responses/200/content/application~1json/example":{"value":{"id":12,"name":"Contact Stage","identifier":"contact_stage","description":"Track the current stage of contacts in your sales pipeline","inputType":"SINGLE_SELECT","type":"CONTACT","CustomFieldOptions":[{"id":53,"name":"New Lead","displayIndex":1,"isArchived":false,"category":"ACTIVE","icon":"user-plus*#6B7280","isDefault":true,"isSystemOption":true,"color":null},{"id":54,"name":"Approved","displayIndex":2,"isArchived":false,"category":"ACTIVE","icon":"check*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":55,"name":"Nurturing","displayIndex":3,"isArchived":false,"category":"ACTIVE","icon":"seedling*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":56,"name":"Contacted","displayIndex":4,"isArchived":false,"category":"ACTIVE","icon":"send*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":57,"name":"Follow-Up Scheduled","displayIndex":5,"isArchived":false,"category":"ACTIVE","icon":"calendar-check*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":58,"name":"Engaged","displayIndex":6,"isArchived":false,"category":"ACTIVE","icon":"check*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":59,"name":"Customer","displayIndex":7,"isArchived":false,"category":"WON","icon":"user-check*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":60,"name":"Onboarded","displayIndex":8,"isArchived":false,"category":"WON","icon":"sparkles*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":61,"name":"Premium Client","displayIndex":9,"isArchived":false,"category":"WON","icon":"diamond*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":62,"name":"Ghosting","displayIndex":10,"isArchived":false,"category":"LOST","icon":"ghost*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":63,"name":"Rejected","displayIndex":11,"isArchived":false,"category":"LOST","icon":"cross*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":64,"name":"Budget Issue","displayIndex":12,"isArchived":false,"category":"LOST","icon":"cash*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":65,"name":"No Decision","displayIndex":13,"isArchived":false,"category":"LOST","icon":"hourglass*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":66,"name":"Not a Fit","displayIndex":14,"isArchived":false,"category":"LOST","icon":"block*#6B7280","isDefault":false,"isSystemOption":true,"color":null}],"CustomFieldOptionsGrouped":{"ACTIVE":[{"id":53,"name":"New Lead","displayIndex":1,"isArchived":false,"category":"ACTIVE","icon":"user-plus*#6B7280","isDefault":true,"isSystemOption":true,"color":null},{"id":54,"name":"Approved","displayIndex":2,"isArchived":false,"category":"ACTIVE","icon":"check*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":55,"name":"Nurturing","displayIndex":3,"isArchived":false,"category":"ACTIVE","icon":"seedling*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":56,"name":"Contacted","displayIndex":4,"isArchived":false,"category":"ACTIVE","icon":"send*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":57,"name":"Follow-Up Scheduled","displayIndex":5,"isArchived":false,"category":"ACTIVE","icon":"calendar-check*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":58,"name":"Engaged","displayIndex":6,"isArchived":false,"category":"ACTIVE","icon":"check*#6B7280","isDefault":false,"isSystemOption":true,"color":null}],"WON":[{"id":59,"name":"Customer","displayIndex":7,"isArchived":false,"category":"WON","icon":"user-check*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":60,"name":"Onboarded","displayIndex":8,"isArchived":false,"category":"WON","icon":"sparkles*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":61,"name":"Premium Client","displayIndex":9,"isArchived":false,"category":"WON","icon":"diamond*#6B7280","isDefault":false,"isSystemOption":true,"color":null}],"LOST":[{"id":62,"name":"Ghosting","displayIndex":10,"isArchived":false,"category":"LOST","icon":"ghost*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":63,"name":"Rejected","displayIndex":11,"isArchived":false,"category":"LOST","icon":"cross*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":64,"name":"Budget Issue","displayIndex":12,"isArchived":false,"category":"LOST","icon":"cash*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":65,"name":"No Decision","displayIndex":13,"isArchived":false,"category":"LOST","icon":"hourglass*#6B7280","isDefault":false,"isSystemOption":true,"color":null},{"id":66,"name":"Not a Fit","displayIndex":14,"isArchived":false,"category":"LOST","icon":"block*#6B7280","isDefault":false,"isSystemOption":true,"color":null}]}},"id":"paths/~1v1~1fields~1contact-stage/get/responses/200/content/application~1json/example"},"paths/~1v1~1fields~1contact-stage/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields~1contact-stage/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields~1contact-stage/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields~1contact-stage/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields~1contact-stage/get/responses/403/content/application~1json/example"},"paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields~1contact-stage/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields~1contact-stage/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields~1contact-stage/get/responses/429/content/application~1json/example"},"paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields~1contact-stage/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields~1objects/get/responses/200/content/application~1json/example":{"value":{"count":43,"data":[{"id":27,"name":"Docs Sample Date","identifier":"{{contact.docs-sample-date}}","inputType":"DATE","type":"CONTACT","isSystemField":false,"hidden":false,"configuration":{"dateType":"ISO","includedTime":false},"createdAt":"2026-04-13T07:15:24.717Z","isSecondaryQuestion":false,"CustomFieldOptions":[],"slug":"contact.docs-sample-date"},{"id":26,"name":"Docs Sample URL","identifier":"{{contact.docs-sample-url}}","inputType":"URL","type":"CONTACT","isSystemField":false,"hidden":false,"configuration":null,"createdAt":"2026-04-13T07:15:24.695Z","isSecondaryQuestion":false,"CustomFieldOptions":[],"slug":"contact.docs-sample-url"},{"id":25,"name":"Docs Sample Email","identifier":"{{contact.docs-sample-email}}","inputType":"EMAIL","type":"CONTACT","isSystemField":false,"hidden":false,"configuration":null,"createdAt":"2026-04-13T07:15:24.669Z","isSecondaryQuestion":false,"CustomFieldOptions":[],"slug":"contact.docs-sample-email"}],"hasMore":true,"nextPage":2},"id":"paths/~1v1~1fields~1objects/get/responses/200/content/application~1json/example"},"paths/~1v1~1fields~1objects/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields~1objects/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields~1objects/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields~1objects/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields~1objects/get/responses/403/content/application~1json/example"},"paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields~1objects/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields~1objects/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields~1objects/get/responses/429/content/application~1json/example"},"paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields~1objects/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1fields~1objects~1all/get/responses/200/content/application~1json/example":{"value":{"data":{"CONTACT":[{"id":22,"name":"Docs Sample Number","identifier":"{{contact.docs-sample-number}}","inputType":"NUMBER","type":"CONTACT","isSystemField":false,"hidden":false,"configuration":{"showMaxValue":false},"createdAt":"2026-04-13T07:15:04.456Z","isSecondaryQuestion":false,"CustomFieldOptions":[],"slug":"contact.docs-sample-number"},{"id":30,"name":"Docs Sample Rating","identifier":"{{contact.docs-sample-rating}}","inputType":"RATING","type":"CONTACT","isSystemField":false,"hidden":false,"configuration":{"maxRating":"5","ratingStyle":"STAR"},"createdAt":"2026-04-13T07:15:24.792Z","isSecondaryQuestion":false,"CustomFieldOptions":[],"slug":"contact.docs-sample-rating"}],"CALL":[{"id":40,"name":"Docs Call Tags","identifier":"{{call.docs-call-tags}}","inputType":"MULTIPLE_SELECT","type":"CALL","isSystemField":false,"hidden":false,"configuration":{"isColorCodeOptions":true},"createdAt":"2026-04-13T07:16:02.580Z","isSecondaryQuestion":false,"CustomFieldOptions":[{"id":106,"name":"Follow up","displayIndex":0,"isArchived":false,"color":"blue","icon":null,"isDefault":false},{"id":107,"name":"Hot","displayIndex":1,"isArchived":false,"color":"red","icon":null,"isDefault":false}],"slug":"call.docs-call-tags"},{"id":39,"name":"Docs Call URL","identifier":"{{call.docs-call-url}}","inputType":"URL","type":"CALL","isSystemField":false,"hidden":false,"configuration":null,"createdAt":"2026-04-13T07:16:02.560Z","isSecondaryQuestion":false,"CustomFieldOptions":[],"slug":"call.docs-call-url"}],"EVENT":[],"DEAL":[],"USER":[],"UNIFIED_INBOX":[],"INVITEE_QUESTION":[{"id":21,"name":"Local Invitee Q","identifier":"{{call.invitee-local-1775678186}}","inputType":"TEXT","type":"CALL","isSystemField":false,"hidden":false,"configuration":null,"createdAt":"2026-04-08T19:56:27.006Z","isSecondaryQuestion":true,"CustomFieldOptions":[],"slug":"call.invitee-local-1775678186"}],"ISCORE":[]}},"id":"paths/~1v1~1fields~1objects~1all/get/responses/200/content/application~1json/example"},"paths/~1v1~1fields~1objects~1all/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1fields~1objects~1all/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1fields~1objects~1all/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1fields~1objects~1all/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1fields~1objects~1all/get/responses/403/content/application~1json/example"},"paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1fields~1objects~1all/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1fields~1objects~1all/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1fields~1objects~1all/get/responses/429/content/application~1json/example"},"paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1fields~1objects~1all/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byEventAndContactIds":{"value":{"eventId":1,"contactId":42,"dateTime":"2026-03-15T14:00:00.000Z","timeZone":"America/New_York","conditionalUsers":"101,102","routingGroupIds":"10","secondaryQuestionsAnswer":[{"customFieldId":1,"answer":["No"]},{"customFieldId":2,"answer":["31"]},{"customFieldId":3,"answer":["Option A","Option B"]}],"additionalGuests":[{"email":"colleague@example.com","name":"Alex Guest"}]},"key":"byEventAndContactIds","summary":"By eventId, contactId, and customFieldIds","id":"paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byEventAndContactIds"},"paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byLinkPrefixAndIdentifiers":{"value":{"linkPrefix":"company/discovery-call","firstName":"Jane","lastName":"Doe","email":"jane.doe@example.com","phoneNumber":"+1 (555) 123-4567","dateTime":"2026-03-15T14:00:00.000Z","timeZone":"America/New_York","conditionalUsers":"101,102","routingGroupIds":"10","secondaryQuestionsAnswer":[{"identifier":"preferred-time","answer":["Morning"]},{"identifier":"company-size","answer":["11-50"]},{"identifier":"notes","answer":["Looking forward to the call."]}]},"key":"byLinkPrefixAndIdentifiers","summary":"By linkPrefix, contact details, and identifiers","id":"paths/~1v1~1eventCalls/post/requestBody/content/application~1json/examples/byLinkPrefixAndIdentifiers"},"paths/~1v1~1eventCalls/post/responses/201/content/application~1json/example":{"value":{"data":{"eventCall":{"message":"Event call created successfully","status":200,"data":{"startTime":"2026-03-15T14:00:00.000Z","endTime":"2026-03-15T14:15:00.000Z","id":1001,"closerId":101,"timeZone":"America/New_York","guestEmail":"jane.doe@example.com","token":"exampleEncryptedConfirmationToken","closerName":"Alex Closer","previewId":"call_examplePreviewId","closerEmail":"closer@example.com","confirmationLink":"https://example.com/c/call_examplePreviewId"}}}},"id":"paths/~1v1~1eventCalls/post/responses/201/content/application~1json/example"},"paths/~1v1~1eventCalls/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1eventCalls/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1eventCalls/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1eventCalls/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1eventCalls/post/responses/403/content/application~1json/example"},"paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1eventCalls/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1eventCalls/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1eventCalls/post/responses/429/content/application~1json/example"},"paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1eventCalls/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1eventCalls/get/responses/201/content/application~1json/example":{"value":{"data":{"eventCalls":[{"id":4,"eventId":2,"dateTime":"2025-12-16 10:15:00.000","userId":5,"location":"PHONE_CALL","notes":null,"isCalendarConnected":false,"isZoomConnected":false,"cancelReason":null,"locationLink":null,"locationLinkInvitee":null,"rescheduledBy":null,"rescheduleReason":null,"cancelledBy":null,"callType":"STRATEGY_EVENT","overBooked":0,"totalOverBooked":0,"duration":30,"durationUnit":"MINUTES","breakBefore":0,"breakAfter":0,"createdAt":"2025-12-10T13:53:59.235Z","updatedAt":"2025-12-10T13:54:00.951Z","googleResponseStatus":null,"additionalGuests":null,"isSlotFree":false,"contactId":2,"user":{"id":5,"firstName":"Alex","lastName":"Closer","email":"closer@example.com"},"callId":4,"deals":[{"id":3,"value":"123","time":"2026-01-21T05:47:37.918Z","transactionType":"WON","product":{"id":1,"name":"Mobile"},"Transaction":[]}],"task":[{"id":4,"completed":true,"outcome":"WON","noSaleReason":null,"objection":"MONEY","notes":"<!DOCTYPE quill-output-html><p>hello</p>"}],"inviteTimeZone":"America/New_York","dateTimeUTC":"2025-12-16T15:15:00.000Z","inviteeEmail":"jane.doe@example.com","inviteeName":"Jane Doe","phoneNumber":"+15551234567","questions":[{"statement":"Phone Number","answer":"+15551234567"},{"statement":"Full Name","answer":"Jane Doe"}],"secondaryAnswers":[{"customFieldId":1,"customFieldIdentifier":"set-by","statement":"Set by","isSecondaryQuestion":false,"answer":[{"inputType":"USER","answer":null,"date":null,"userId":5,"number":null,"user":{"firstName":"Alex","lastName":"Closer"}}]},{"customFieldId":2,"customFieldIdentifier":"objection","statement":"Objection","isSecondaryQuestion":false,"answer":[{"inputType":"SINGLE_SELECT","answer":"MONEY","date":null,"userId":null,"number":null,"user":null}]},{"customFieldId":3,"customFieldIdentifier":"call-outcome","statement":"Call Outcome","isSecondaryQuestion":false,"answer":[{"inputType":"SINGLE_SELECT","answer":"WON","date":null,"userId":null,"number":null,"user":null}]}],"eventType":"PAST","utm":[{"utmKey":"string","utmValue":""},{"utmKey":"utm_source","utmValue":"google"},{"utmKey":"utm_medium","utmValue":"cpc"}],"contact":{"email":"jane.doe@example.com","phoneNumber":"+15551234567","previewId":"contact_examplePreviewId","secondary_email":null,"secondary_phoneNumber":null},"event":{"allowInviteeAdditionalGuests":false,"allowReschedule":true,"color":"#0099FF","duration":30,"durationUnit":"MINUTES","eventType":"STRATEGY_EVENT","internalDescription":"","linkPrefix":"company/phone-call","location":"PHONE_CALL","name":"Phone Call"}}],"count":8}},"id":"paths/~1v1~1eventCalls/get/responses/201/content/application~1json/example"},"paths/~1v1~1eventCalls/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1eventCalls/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1eventCalls/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1eventCalls/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1eventCalls/get/responses/403/content/application~1json/example"},"paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1eventCalls/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1eventCalls/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1eventCalls/get/responses/429/content/application~1json/example"},"paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1eventCalls/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1eventCalls~1reschedule/put/requestBody/content/application~1json/example":{"value":{"id":1001,"dateTime":"2026-07-24T16:45:00.000Z","timeZone":"America/New_York","rescheduleReason":"Client requested a different time","notes":"Internal note for the reschedule","userId":101,"additionalGuests":[{"email":"colleague@example.com","name":"Alex Guest"}]},"id":"paths/~1v1~1eventCalls~1reschedule/put/requestBody/content/application~1json/example"},"paths/~1v1~1eventCalls~1reschedule/put/responses/200/content/application~1json/example":{"value":{"message":"Event call updated successfully","status":200,"data":{"closerName":"Alex Closer","closerEmail":"closer@example.com","dateTime":"2026-07-24T16:45:00.000Z","duration":15,"durationUnit":"MINUTES","name":"Discovery Call","location":"GOOGLE_MEET","inviteeEmail":"jane.doe@example.com","inviteeName":"Jane Doe","previewId":"call_examplePreviewId","userId":101}},"id":"paths/~1v1~1eventCalls~1reschedule/put/responses/200/content/application~1json/example"},"paths/~1v1~1eventCalls~1reschedule/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1eventCalls~1reschedule/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1eventCalls~1reschedule/put/responses/403/content/application~1json/example"},"paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1eventCalls~1reschedule/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1eventCalls~1reschedule/put/responses/429/content/application~1json/example"},"paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1eventCalls~1reschedule/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1eventCalls~1cancel/put/requestBody/content/application~1json/example":{"value":{"id":1001,"cancelReason":"Client requested cancellation"},"id":"paths/~1v1~1eventCalls~1cancel/put/requestBody/content/application~1json/example"},"paths/~1v1~1eventCalls~1cancel/put/responses/200/content/application~1json/example":{"value":{"data":{"eventCall":{"message":"Call cancelled successfully","status":200}}},"id":"paths/~1v1~1eventCalls~1cancel/put/responses/200/content/application~1json/example"},"paths/~1v1~1eventCalls~1cancel/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1eventCalls~1cancel/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1eventCalls~1cancel/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1eventCalls~1cancel/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1eventCalls~1cancel/put/responses/403/content/application~1json/example"},"paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1eventCalls~1cancel/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1eventCalls~1cancel/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1eventCalls~1cancel/put/responses/429/content/application~1json/example"},"paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1eventCalls~1cancel/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1eventCalls~1markSlotFree/put/requestBody/content/application~1json/example":{"value":{"id":6,"isSlotFree":true},"id":"paths/~1v1~1eventCalls~1markSlotFree/put/requestBody/content/application~1json/example"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/200/content/application~1json/example":{"value":{"success":true,"message":"Slot free status updated successfully","data":{"id":6,"isSlotFree":true,"googleEventId":"event_google_calendar_id_123"}},"id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/200/content/application~1json/example"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/403/content/application~1json/example"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/429/content/application~1json/example"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1eventCalls~1markSlotFree/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1transactions/get/responses/200/content/application~1json/example":{"value":{"count":2,"data":[{"id":1,"accountId":1,"name":"Jane Doe","email":"jane.doe@example.com","phoneNumber":"+15551234567","description":"Test zapier ","value":300.56,"currency":null,"source":"Zapier","updatedBy":"Zapier","createdAt":"2026-03-10T08:11:15.963Z","updatedAt":"2026-03-10T08:11:15.963Z","syncedDeal":null,"deal":null},{"id":1,"accountId":1,"name":"Jane Doe","email":"jane23.doe@example.com","phoneNumber":"+15551234567","description":"Test zapier ","value":300.56,"currency":null,"source":"Zapier","updatedBy":"Zapier","createdAt":"2026-03-09T14:30:53.751Z","updatedAt":"2026-03-09T14:30:53.751Z","syncedDeal":null,"deal":null}]},"id":"paths/~1v1~1transactions/get/responses/200/content/application~1json/example"},"paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1transactions/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1transactions/get/responses/403/content/application~1json/example"},"paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1transactions/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1transactions/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1transactions/get/responses/429/content/application~1json/example"},"paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/example":{"value":{"name":"John Doe","phoneNumber":"+15551234567","description":"Test transaction","email":"user@example.com","value":0,"source":"Zapier"},"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/example"},"paths/~1v1~1transactions/post/responses/201/content/application~1json/example":{"value":{"message":"Transaction added successfully","status":200,"data":{"transaction":{"id":1,"accountId":1,"syncedDeal":0,"name":"Jane Doe","email":"jane23.doe@example.com","phoneNumber":"+15551234567","description":"Test zapier ","value":"0","currency":"usd","source":"Zapier","updatedBy":"User","createdAt":"2026-03-10T13:30:07.851Z","updatedAt":"2026-03-10T13:30:07.851Z","deletedAt":null}}},"id":"paths/~1v1~1transactions/post/responses/201/content/application~1json/example"},"paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1transactions/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1transactions/post/responses/403/content/application~1json/example"},"paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1transactions/post/responses/404/content/application~1json/examples/record"},"paths/~1v1~1transactions/post/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1transactions/post/responses/429/content/application~1json/example"},"paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1transactions/put/requestBody/content/application~1json/example":{"value":{"id":1,"name":"John Doe","phoneNumber":"+15551234567","description":"Test transaction","email":"user@example.com","value":0,"source":"Zapier"},"id":"paths/~1v1~1transactions/put/requestBody/content/application~1json/example"},"paths/~1v1~1transactions/put/responses/200/content/application~1json/example":{"value":{"data":{"transaction":{"id":1,"accountId":1,"syncedDeal":0,"name":"Example Name","email":"user@example.com","phoneNumber":"+15551234567","description":"Test transaction","value":"0","currency":"usd","source":"Zapier","updatedBy":"User","createdAt":"2026-03-10T13:30:07.851Z","updatedAt":"2026-03-10T13:34:11.812Z","deletedAt":null}}},"id":"paths/~1v1~1transactions/put/responses/200/content/application~1json/example"},"paths/~1v1~1transactions/put/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1transactions/put/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1transactions/put/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1transactions/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1transactions/put/responses/403/content/application~1json/example"},"paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1transactions/put/responses/404/content/application~1json/examples/record"},"paths/~1v1~1transactions/put/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1transactions/put/responses/429/content/application~1json/example"},"paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1transactions/put/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1transactions/delete/responses/200/content/application~1json/example":{"value":{"message":"Transaction deleted successfully","status":200},"id":"paths/~1v1~1transactions/delete/responses/200/content/application~1json/example"},"paths/~1v1~1transactions/delete/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1transactions/delete/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1transactions/delete/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1transactions/delete/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1transactions/delete/responses/403/content/application~1json/example"},"paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1transactions/delete/responses/404/content/application~1json/examples/record"},"paths/~1v1~1transactions/delete/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1transactions/delete/responses/429/content/application~1json/example"},"paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1transactions/delete/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1userAvailabilities/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":1,"name":"test","userId":101,"timeZone":"America/Los_Angeles","isDefault":false,"userAvailabilityDays":[{"id":1,"name":"monday","active":true,"timings":[{"startTime":"09:00","endTime":"17:30"},{"startTime":"17:15","endTime":"17:45"},{"startTime":"18:00","endTime":"18:30"},{"startTime":"18:45","endTime":"19:15"}]},{"id":2,"name":"tuesday","active":true,"timings":[{"startTime":"09:00","endTime":"17:00"},{"startTime":"17:15","endTime":"17:45"},{"startTime":"18:00","endTime":"18:30"},{"startTime":"18:45","endTime":"19:15"},{"startTime":"19:30","endTime":"20:00"}]},{"id":3,"name":"wednesday","active":true,"timings":[{"startTime":"09:00","endTime":"17:00"},{"startTime":"17:15","endTime":"17:45"},{"startTime":"18:00","endTime":"18:30"},{"startTime":"18:45","endTime":"19:15"},{"startTime":"19:30","endTime":"20:00"}]},{"id":4,"name":"thursday","active":true,"timings":[{"startTime":"09:00","endTime":"17:00"},{"startTime":"17:15","endTime":"17:45"},{"startTime":"18:00","endTime":"18:30"},{"startTime":"18:45","endTime":"19:15"},{"startTime":"19:30","endTime":"20:00"},{"startTime":"20:15","endTime":"20:45"},{"startTime":"21:00","endTime":"21:30"},{"startTime":"21:45","endTime":"22:15"}]},{"id":5,"name":"friday","active":true,"timings":[{"startTime":"09:00","endTime":"17:00"},{"startTime":"17:15","endTime":"17:45"},{"startTime":"18:00","endTime":"18:30"},{"startTime":"18:45","endTime":"19:15"},{"startTime":"19:30","endTime":"20:00"},{"startTime":"20:15","endTime":"20:45"}]},{"id":6,"name":"saturday","active":true,"timings":[{"startTime":"09:00","endTime":"17:00"},{"startTime":"17:15","endTime":"17:45"},{"startTime":"18:00","endTime":"18:30"},{"startTime":"18:45","endTime":"19:15"},{"startTime":"19:30","endTime":"20:00"},{"startTime":"20:15","endTime":"20:45"},{"startTime":"21:00","endTime":"21:30"},{"startTime":"21:45","endTime":"22:15"},{"startTime":"22:30","endTime":"23:00"},{"startTime":"23:15","endTime":"23:45"}]},{"id":7,"name":"sunday","active":true,"timings":[{"startTime":"09:00","endTime":"17:00"},{"startTime":"17:15","endTime":"17:45"},{"startTime":"18:00","endTime":"18:30"},{"startTime":"18:45","endTime":"19:15"}]}],"eventId":[1,2,10]},{"id":2,"name":"Working Hours","userId":101,"timeZone":"America/New_York","isDefault":true,"userAvailabilityDays":[{"id":1,"name":"monday","active":true,"timings":[{"startTime":"00:00","endTime":"23:40"}]},{"id":2,"name":"tuesday","active":true,"timings":[{"startTime":"00:00","endTime":"23:45"}]},{"id":3,"name":"wednesday","active":true,"timings":[{"startTime":"00:00","endTime":"23:45"}]},{"id":4,"name":"thursday","active":true,"timings":[{"startTime":"00:00","endTime":"23:45"}]},{"id":5,"name":"friday","active":true,"timings":[{"startTime":"00:00","endTime":"23:45"}]},{"id":6,"name":"saturday","active":true,"timings":[{"startTime":"00:00","endTime":"23:45"}]},{"id":7,"name":"sunday","active":true,"timings":[{"startTime":"00:00","endTime":"23:45"}]}],"eventId":[1,2,3]}]},"id":"paths/~1v1~1userAvailabilities/get/responses/200/content/application~1json/example"},"paths/~1v1~1userAvailabilities/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1userAvailabilities/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1userAvailabilities/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1userAvailabilities/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1userAvailabilities/get/responses/403/content/application~1json/example"},"paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1userAvailabilities/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1userAvailabilities/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1userAvailabilities/get/responses/429/content/application~1json/example"},"paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1userAvailabilities/get/responses/500/content/application~1json/examples/withMessage"},"paths/~1v1~1users/get/responses/200/content/application~1json/example":{"value":{"data":{"users":[{"id":101,"firstName":"Alex","lastName":"Closer","email":"closer@example.com","phoneNumber":"+15551234567","timeZone":"America/New_York","createdAt":"2024-12-10T10:04:34.743Z","deletedAt":null,"role":"user","integrations":[]},{"id":102,"firstName":"Sam","lastName":"Admin","email":"admin@example.com","phoneNumber":"+15559876543","timeZone":"America/New_York","createdAt":"2025-04-04T14:33:26.258Z","deletedAt":"2025-06-01T12:00:00.000Z","role":"admin","integrations":[{"name":"googleCalendar","platform_id":"admin@example.com"}]}],"count":2}},"id":"paths/~1v1~1users/get/responses/200/content/application~1json/example"},"paths/~1v1~1users/get/responses/400/content/application~1json/examples/validationZodDetails":{"value":{"message":"Invalid input: expected number, received undefined","details":{"formErrors":[],"fieldErrors":{"eventCallId":["Invalid input: expected number, received undefined"]}}},"key":"validationZodDetails","summary":"Zod validation (body/query)","id":"paths/~1v1~1users/get/responses/400/content/application~1json/examples/validationZodDetails"},"paths/~1v1~1users/get/responses/401/content/application~1json/examples/missing":{"value":{"message":"API key is required"},"key":"missing","summary":"Missing API key","id":"paths/~1v1~1users/get/responses/401/content/application~1json/examples/missing"},"paths/~1v1~1users/get/responses/401/content/application~1json/examples/invalid":{"value":{"message":"Invalid API key"},"key":"invalid","summary":"Invalid API key","id":"paths/~1v1~1users/get/responses/401/content/application~1json/examples/invalid"},"paths/~1v1~1users/get/responses/401/content/application~1json/examples/missingFromRateLimiter":{"value":{"code":"MISSING_API_KEY","message":"API key is required for this endpoint"},"key":"missingFromRateLimiter","summary":"Missing auth when rate limiter runs first","id":"paths/~1v1~1users/get/responses/401/content/application~1json/examples/missingFromRateLimiter"},"paths/~1v1~1users/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden access"},"id":"paths/~1v1~1users/get/responses/403/content/application~1json/example"},"paths/~1v1~1users/get/responses/404/content/application~1json/examples/generic":{"value":{"message":"Resource not found!"},"key":"generic","summary":"Generic not found","id":"paths/~1v1~1users/get/responses/404/content/application~1json/examples/generic"},"paths/~1v1~1users/get/responses/404/content/application~1json/examples/record":{"value":{"message":"Record not found!"},"key":"record","summary":"Record not found","id":"paths/~1v1~1users/get/responses/404/content/application~1json/examples/record"},"paths/~1v1~1users/get/responses/429/content/application~1json/example":{"value":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later."},"id":"paths/~1v1~1users/get/responses/429/content/application~1json/example"},"paths/~1v1~1users/get/responses/500/content/application~1json/examples/generic":{"value":{"message":"Something went wrong"},"key":"generic","summary":"Generic (e.g. Prisma errors)","id":"paths/~1v1~1users/get/responses/500/content/application~1json/examples/generic"},"paths/~1v1~1users/get/responses/500/content/application~1json/examples/withMessage":{"value":{"message":"Database connection failed"},"key":"withMessage","summary":"Error with message","id":"paths/~1v1~1users/get/responses/500/content/application~1json/examples/withMessage"}},"securitySchemeStore":{"bearerAuth":{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key required in Authorization header. Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iclosed-<token>"},"children":[]}]}]}]},"oauth2":{"id":"oauth2","type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.1 authorization code with PKCE (S256). Third-party clients open the iClosed consent page, receive an authorization code on their redirect URI, then exchange it at the token endpoint. Public clients must send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code_verifier"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; confidential clients may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the token endpoint."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"https://app.iclosed.io/oauth/authorize","tokenUrl":"https://public.api.iclosed.io/v1/oauth/token","scopes":{"contacts:read":"Read contacts","contacts:write":"Create and update contacts","contacts.notes:read":"Read contact notes","contacts.notes:write":"Create and update contact notes","fields:read":"Read custom fields","fields:write":"Create and update custom fields","deals:read":"Read deals","deals:write":"Create and update deals","events:read":"Read events and availability","events:write":"Create and update events","eventCalls:read":"Read scheduled calls","eventCalls:write":"Create and update scheduled calls","outcomes:write":"Record call outcomes","products:read":"Read products","products:write":"Create and update products","transactions:read":"Read transactions","transactions:write":"Create and update transactions","transactions:delete":"Delete transactions","availabilities:read":"Read user availabilities","users:read":"Read users","oauth:clients:read":"List registered OAuth clients (account management)","oauth:clients:write":"Register OAuth clients via dynamic client registration"}}}}},"servers":[{"url":"/_mock/openapi/v1/openapi","isMockServer":true,"description":"Mock server"},{"url":"https://public.api.iclosed.io","description":"Production"},{"url":"https://public-dev.api.iclosed.io","description":"Development (use for local integration tests; published specs avoid localhost per lint rules)"}]},"options":{"jsonSamplesExpandLevel":"all","hideSidebar":true,"mockServer":{"url":"/_mock/openapi/v1/openapi","position":"first","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/openapi/v1/openapi.json?download"},{"url":"/_bundle/openapi/v1/openapi.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Introduction","description":"V1 Public API with account based rate limiting. All requests require API key in Authorization header."}},"baseSlug":"/openapi/v1/openapi","routesMapping":{}}