{"openapi":"3.1.0","info":{"title":"Attio Standard Objects","version":"2.0.0"},"security":[{"oauth2":[]}],"servers":[{"url":"https://api.attio.com","description":"Production"}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"This API uses OAuth 2.0 with the authorization code grant flow.","flows":{"authorizationCode":{"authorizationUrl":"https://app.attio.com/authorize","tokenUrl":"https://app.attio.com/oauth/token","scopes":{"user_management:read":"View workspace members.","user_management:read-write":"View workspace members.","record_permission:read":"View, and optionally write, records.","record_permission:read-write":"View, and optionally write, records.","object_configuration:read":"View, and optionally write, the configuration and attributes of objects.","object_configuration:read-write":"View, and optionally write, the configuration and attributes of objects.","list_entry:read":"View, and optionally write, the entries in a list.","list_entry:read-write":"View, and optionally write, the entries in a list.","list_configuration:read":"View, and optionally write, the configuration and attributes of lists.","list_configuration:read-write":"View, and optionally write, the configuration and attributes of lists.","public_collection:read":"View, and optionally write, both the settings and information within public collections.","public_collection:read-write":"View, and optionally write, both the settings and information within public collections.","private_collection:read":"View, and optionally modify, both the settings and information of all collections within the workspace, regardless of their access settings.","private_collection:read-write":"View, and optionally modify, both the settings and information of all collections within the workspace, regardless of their access settings.","comment:read":"View comments (and threads), and optionally write comments.","comment:read-write":"View comments (and threads), and optionally write comments.","task:read":"View, and optionally write, tasks.","task:read-write":"View, and optionally write, tasks.","note:read":"View, and optionally write, notes.","note:read-write":"View, and optionally write, notes.","meeting:read":"View, and optionally write, meetings.","meeting:read-write":"View, and optionally write, meetings.","call_recording:read":"View, and optionally write, call recordings, transcripts and speakers for meetings.","call_recording:read-write":"View, and optionally write, call recordings, transcripts and speakers for meetings.","webhook:read":"View, and optionally manage, webhooks.","webhook:read-write":"View, and optionally manage, webhooks.","file:read":"View, and upload files.","file:read-write":"View, and upload files."}}}}},"schemas":{"status":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"The ID of the workspace","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"The ID of the object","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"attribute_id":{"type":"string","format":"uuid","description":"The ID of the attribute","example":"41252299-f8c7-4b5e-99c9-4ff8321d2f96"},"status_id":{"type":"string","format":"uuid","description":"The ID of the status","example":"11f07f01-c10f-4e05-a522-33e050bc52ee"}},"required":["workspace_id","object_id","attribute_id","status_id"]},"title":{"type":"string","description":"The title of the status","example":"In Progress"},"is_archived":{"type":"boolean","description":"Whether or not to archive the status. See our [archiving guide](/docs/archiving-vs-deleting) for more information on archiving.","example":false},"celebration_enabled":{"type":"boolean","description":"Whether arriving at this status triggers a celebration effect in the UI","example":false},"target_time_in_status":{"type":["string","null"],"description":"Target time for a record to spend in given status expressed as a ISO-8601 duration string","example":"P0Y0M1DT0H0M0S"}},"required":["id","title","is_archived","celebration_enabled","target_time_in_status"]},"select-option":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"The ID of the workspace","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"The ID of the object","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"attribute_id":{"type":"string","format":"uuid","description":"The ID of the attribute","example":"41252299-f8c7-4b5e-99c9-4ff8321d2f96"},"option_id":{"type":"string","format":"uuid","description":"The ID of the select option","example":"08c2c59a-c18e-40c6-8dc4-95415313b2ea"}},"required":["workspace_id","object_id","attribute_id","option_id"]},"title":{"type":"string","description":"The title of the select option","example":"Medium"},"is_archived":{"type":"boolean","description":"Whether or not to archive the select option. See our [archiving guide](/docs/archiving-vs-deleting) for more information on archiving.","example":false}},"required":["id","title","is_archived"]}},"parameters":{}},"paths":{"/v2/objects/people/records/query":{"post":{"summary":"List person records ","description":"Lists person records, with the option to filter and sort results.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["People"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"object","description":"An object used to filter results to a subset of records. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","additionalProperties":true,"example":{"$and":[{"name":{"first_name":{"$eq":"John"},"last_name":{"$eq":"Smith"}}},{"description":{"value":{"$contains":"event"}}}]}},"sorts":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"attribute":{"type":"string","description":"A slug or ID to identify the attribute to sort by."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","attribute"],"description":"Sort by attribute"},{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"path":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","description":"The slug or ID of the object e.g. \"people\"."},{"type":"string","description":"A slug or ID to identify the attribute to sort by."}]},"minItems":2,"maxItems":2},"description":"You may use the `path` property to traverse record reference attributes and parent records on list entries. `path` accepts an array of tuples where the first element of each tuple is the slug or ID of a list/object, and the second element is the slug or ID of an attribute on that list/object. The first element of the first tuple must correspond to the list or object that you are querying. For example, if you wanted to sort by the name of the parent record (a company) on a list with the slug \"sales\", you would pass the value `[['sales', 'parent_record'], ['companies', 'name']]`."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","path"],"description":"Sort by path"}]},"description":"An object used to sort results. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","example":[{"direction":"asc","attribute":"name","field":"last_name"}]},"limit":{"type":"number","description":"The maximum number of results to return. Defaults to 500. See the [full guide to pagination here](/rest-api/guides/pagination).","example":500},"offset":{"type":"number","description":"The number of results to skip over before returning. Defaults to 0. See the [full guide to pagination here](/rest-api/guides/pagination).","example":0}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `email_addresses` or `name`) can be used, including custom attribute slugs.","example":{"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/johnsmith","attribute_type":"text"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"job_title":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Software Engineer","attribute_type":"text"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"f528bd86-8142-4359-9a8c-b651d50a27b1","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"locality":"Cupertino","region":"CA","postcode":"95014","country_code":"US","latitude":"37.331741","longitude":"-122.030333","attribute_type":"location"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/johnsmith","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Developer met at event","attribute_type":"text"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"email_addresses":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"john-smith@attio.com","email_address":"john-smith@attio.com","email_domain":"attio.com","email_root_domain":"attio.com","email_local_specifier":"john-smith","attribute_type":"email-address"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01T15:00:00.000000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/johnsmith","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/johnsmith","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"first_name":"John","last_name":"Smith","full_name":"John Smith","attribute_type":"personal-name"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/johnsmith","attribute_type":"text"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"phone_numbers":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"country_code":"US","original_phone_number":"+15558675309","phone_number":"+15558675309","attribute_type":"phone-number"}]}}},"required":["id","created_at","web_url","values"]}}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["filter_error"]},"message":{"type":"string","example":"Error in filter."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"The referenced object was not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/people/records":{"post":{"summary":"Create a person Record","description":"Creates a new person Record. This endpoint will throw on conflicts of unique attributes, like `email_addresses`. If you would prefer to update person records on conflicts, please use the Assert person record endpoint instead. Please note, the `avatar_url` attribute cannot currently be set via the API.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["People"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"email_address":{"type":"string","description":"An email address string","example":"alice@app.attio.com"}}}},"name":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","example":"Ada","description":"The first name."},"last_name":{"type":"string","example":"Lovelace","description":"The last name."},"full_name":{"type":"string","example":"Ada Lovelace","description":"The full name."}}}},"description":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","required":["original_phone_number"],"properties":{"original_phone_number":{"type":"string","example":"+15558675309","description":"A phone number which is either a) prefixed with a country code (e.g. `+44....`) or b) a local number, where `country_code` is specified in addition."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to. Optional if `original_phone_number` includes a country code prefix."}}}},"linkedin":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"}},"required":["line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42}},"required":["value"],"additionalProperties":false}},"company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard person attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"email_addresses":["john-smith@attio.com"],"name":[{"first_name":"John","last_name":"Smith","full_name":"John Smith"}],"description":"Developer met at event","company":[{"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},{"target_object":"companies","domains":[{"domain":"attio.com"}]}],"phone_numbers":[{"original_phone_number":"+15558675309","country_code":"US"}],"primary_location":[{"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"locality":"Cupertino","region":"CA","postcode":"95014","country_code":"US","latitude":"37.331741","longitude":"-122.030333"}],"linkedin":"https://linkedin.com/in/johnsmith"}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `email_addresses` or `name`) can be used, including custom attribute slugs.","example":{"email_addresses":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"john-smith@attio.com","email_address":"john-smith@attio.com","email_domain":"attio.com","email_root_domain":"attio.com","email_local_specifier":"john-smith","attribute_type":"email-address"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"first_name":"John","last_name":"Smith","full_name":"John Smith","attribute_type":"personal-name"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Developer met at event","attribute_type":"text"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01T15:00:00.000000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"strongest_connection_strength_legacy":[],"last_interaction":[],"twitter":[],"avatar_url":[],"job_title":[],"next_calendar_interaction":[],"company":[],"primary_location":[],"angellist":[],"strongest_connection_user":[],"strongest_connection_strength":[],"last_email_interaction":[],"first_interaction":[],"last_calendar_interaction":[],"linkedin":[],"facebook":[],"first_calendar_interaction":[],"twitter_follower_count":[],"instagram":[],"first_email_interaction":[],"phone_numbers":[]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"Cannot find select attribute with select option title \"In Progress\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"put":{"summary":"Assert a person Record","description":"Use this endpoint to create or update person records, using a unique attribute to search for existing People (for example the `email_addresses` attribute). If a person is found with the same value for the matching attribute, that person will be updated. If no person with the same value for the matching attribute is found, a new person will be created instead. If you would like to avoid matching, please use the Create person endpoint.\n\n\nIf the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["People"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"The ID or slug of the attribute to use to check if a person already exists. The attribute must be unique. For person records `email_addresses` is the only unique attribute.","example":"email_addresses"},"required":true,"name":"matching_attribute","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"email_address":{"type":"string","description":"An email address string","example":"alice@app.attio.com"}}}},"name":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","example":"Ada","description":"The first name."},"last_name":{"type":"string","example":"Lovelace","description":"The last name."},"full_name":{"type":"string","example":"Ada Lovelace","description":"The full name."}}}},"description":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","required":["original_phone_number"],"properties":{"original_phone_number":{"type":"string","example":"+15558675309","description":"A phone number which is either a) prefixed with a country code (e.g. `+44....`) or b) a local number, where `country_code` is specified in addition."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to. Optional if `original_phone_number` includes a country code prefix."}}}},"linkedin":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"}},"required":["line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42}},"required":["value"],"additionalProperties":false}},"company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard person attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"email_addresses":["john-smith@attio.com"],"name":[{"first_name":"John","last_name":"Smith","full_name":"John Smith"}],"description":"Developer met at event","company":[{"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},{"target_object":"companies","domains":[{"domain":"attio.com"}]}],"phone_numbers":[{"original_phone_number":"+15558675309","country_code":"US"}],"primary_location":[{"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"locality":"Cupertino","region":"CA","postcode":"95014","country_code":"US","latitude":"37.331741","longitude":"-122.030333"}],"linkedin":"https://linkedin.com/in/johnsmith"}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `email_addresses` or `name`) can be used, including custom attribute slugs.","example":{"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/johnsmith","attribute_type":"text"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"job_title":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Software Engineer","attribute_type":"text"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"f528bd86-8142-4359-9a8c-b651d50a27b1","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"locality":"Cupertino","region":"CA","postcode":"95014","country_code":"US","latitude":"37.331741","longitude":"-122.030333","attribute_type":"location"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/johnsmith","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Developer met at event","attribute_type":"text"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"email_addresses":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"john-smith@attio.com","email_address":"john-smith@attio.com","email_domain":"attio.com","email_root_domain":"attio.com","email_local_specifier":"john-smith","attribute_type":"email-address"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01T15:00:00.000000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/johnsmith","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/johnsmith","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"first_name":"John","last_name":"Smith","full_name":"John Smith","attribute_type":"personal-name"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/johnsmith","attribute_type":"text"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"phone_numbers":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"country_code":"US","original_phone_number":"+15558675309","phone_number":"+15558675309","attribute_type":"phone-number"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"No attribute was found for matching_attribute slug/ID \"my-attribute\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/people/records/{record_id}":{"get":{"summary":"Get a person Record","description":"Gets a single person record by its `record_id`.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["People"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the person record to fetch.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `email_addresses` or `name`) can be used, including custom attribute slugs.","example":{"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/johnsmith","attribute_type":"text"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"job_title":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Software Engineer","attribute_type":"text"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"f528bd86-8142-4359-9a8c-b651d50a27b1","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"locality":"Cupertino","region":"CA","postcode":"95014","country_code":"US","latitude":"37.331741","longitude":"-122.030333","attribute_type":"location"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/johnsmith","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Developer met at event","attribute_type":"text"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"email_addresses":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"john-smith@attio.com","email_address":"john-smith@attio.com","email_domain":"attio.com","email_root_domain":"attio.com","email_local_specifier":"john-smith","attribute_type":"email-address"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01T15:00:00.000000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/johnsmith","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/johnsmith","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"first_name":"John","last_name":"Smith","full_name":"John Smith","attribute_type":"personal-name"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/johnsmith","attribute_type":"text"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"phone_numbers":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"country_code":"US","original_phone_number":"+15558675309","phone_number":"+15558675309","attribute_type":"phone-number"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"patch":{"summary":"Update a person Record","description":"Use this endpoint to update person records by `record_id`. If the update payload includes multiselect attributes, the values supplied will be created and prepended to the list of values that already exist (if any). Use the [Assert person endpoint](/reference/put_v2-objects-people-records) to overwrite or remove multiselect attribute values. Please note, the `avatar_url` attribute cannot currently be updated via the API.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["People"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the person record to update.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"required":true,"name":"record_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"email_address":{"type":"string","description":"An email address string","example":"alice@app.attio.com"}}}},"name":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","example":"Ada","description":"The first name."},"last_name":{"type":"string","example":"Lovelace","description":"The last name."},"full_name":{"type":"string","example":"Ada Lovelace","description":"The full name."}}}},"description":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","required":["original_phone_number"],"properties":{"original_phone_number":{"type":"string","example":"+15558675309","description":"A phone number which is either a) prefixed with a country code (e.g. `+44....`) or b) a local number, where `country_code` is specified in addition."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to. Optional if `original_phone_number` includes a country code prefix."}}}},"linkedin":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"}},"required":["line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42}},"required":["value"],"additionalProperties":false}},"company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard person attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"email_addresses":["john-smith@attio.com"],"name":[{"first_name":"John","last_name":"Smith","full_name":"John Smith"}],"description":"Developer met at event","company":[{"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},{"target_object":"companies","domains":[{"domain":"attio.com"}]}],"phone_numbers":[{"original_phone_number":"+15558675309","country_code":"US"}],"primary_location":[{"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"locality":"Cupertino","region":"CA","postcode":"95014","country_code":"US","latitude":"37.331741","longitude":"-122.030333"}],"linkedin":"https://linkedin.com/in/johnsmith"}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"email_addresses":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"job_title":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `email_addresses` or `name`) can be used, including custom attribute slugs.","example":{"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/johnsmith","attribute_type":"text"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"job_title":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Software Engineer","attribute_type":"text"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"f528bd86-8142-4359-9a8c-b651d50a27b1","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"locality":"Cupertino","region":"CA","postcode":"95014","country_code":"US","latitude":"37.331741","longitude":"-122.030333","attribute_type":"location"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/johnsmith","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Developer met at event","attribute_type":"text"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"email_addresses":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"john-smith@attio.com","email_address":"john-smith@attio.com","email_domain":"attio.com","email_root_domain":"attio.com","email_local_specifier":"john-smith","attribute_type":"email-address"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"system","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01T15:00:00.000000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/johnsmith","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/johnsmith","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"first_name":"John","last_name":"Smith","full_name":"John Smith","attribute_type":"personal-name"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/johnsmith","attribute_type":"text"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"phone_numbers":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"country_code":"US","original_phone_number":"+15558675309","phone_number":"+15558675309","attribute_type":"phone-number"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["missing_value"]},"message":{"type":"string","example":"Required value for attribute with ID \"41252299-f8c7-4b5e-99c9-4ff8321d2f96\" was not provided."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"delete":{"summary":"Delete a person Record","description":"Deletes a single person record by ID.\n\nRequired scopes: `object_configuration:read`, `record_permission:read-write`.","tags":["People"],"security":[{"oauth2":["object_configuration:read","record_permission:read-write"]}],"parameters":[{"schema":{"type":"string","description":"The UUID of the person record to delete.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{},"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/people/records/{record_id}/attributes/{attribute}/values":{"get":{"summary":"List person record attribute values","description":"Gets all values for a given attribute on a person record. Historic values can be queried using the `show_historic` query param. Historic values cannot be queried on COMINT (Communication Intelligence) or enriched attributes and the endpoint will return a 400 error if this is attempted. Historic values are sorted from oldest to newest (by `active_from`). Some attributes are subject to billing status and will return an empty array of values if theworkspace being queried does not have the required billing flag enabled.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["People"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the person record to fetch attribute values for.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"string","description":"A UUID or slug to identify the attribute you want to query values on.","example":"name"},"required":true,"name":"attribute","in":"path"},{"schema":{"type":"boolean","description":"If `true`, the endpoint will return all historic values for the attribute. If `false`, the endpoint will only return the currently active value(s). Defaults to `false`. Cannot be set to `true` for COMINT attributes or enriched attributes on people/company objects.","example":true,"default":false},"required":false,"name":"show_historic","in":"query"},{"schema":{"type":"integer","description":"The maximum number of results to return. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"boolean","description":"A boolean representing whether the checkbox is checked or not. The string values 'true' and 'false' are also accepted.","example":true},"attribute_type":{"type":"string","enum":["checkbox"],"description":"The attribute type of the value.","example":"checkbox"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"A number between 0 and 5 (inclusive) to represent a star rating.","example":3},"attribute_type":{"type":"string","enum":["rating"],"description":"The attribute type of the value.","example":"rating"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}]}}},"required":["data"],"description":"Success","example":{"data":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"first_name":"John","last_name":"Smith","full_name":"John Smith","attribute_type":"personal-name"}]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["validation_type"]},"message":{"type":"string","example":"Cannot set show_historic param to true when querying a COMINT attribute."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Attribute with slug/ID \"my-attribute\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/people/records/{record_id}/entries":{"get":{"summary":"List person record entries","description":"List all entries, across all lists, for which this person record is the parent.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`, `list_entry:read`.","tags":["People"],"security":[{"oauth2":["record_permission:read","object_configuration:read","list_entry:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the person record to fetch entries for.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"integer","description":"The maximum number of results to return. The default is `100` and the maximum is `1000`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. The default is `0`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"list_id":{"type":"string","format":"uuid","description":"A UUID identifying the list that this record is in.","example":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"},"list_api_slug":{"type":"string","description":"A human-readable slug for the list for use in URLs and responses.","example":"hiring-engineering"},"entry_id":{"type":"string","format":"uuid","description":"A UUID identifying this entry on the list.","example":"2e6e29ea-c4e0-4f44-842d-78a891f8c156"},"created_at":{"type":"string","description":"When this entry was created.","example":"2022-11-21T13:22:49.061281000Z"}},"required":["list_id","list_api_slug","entry_id","created_at"]}}},"required":["data"],"description":"Success"}}}}}}},"/v2/objects/companies/records/query":{"post":{"summary":"List company records","description":"Lists company records, with the option to filter and sort results.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Companies"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"object","description":"An object used to filter results to a subset of records. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","additionalProperties":true,"example":{"$and":[{"domains":{"domain":{"$eq":"attio.com"}}},{"description":{"value":{"$contains":"magic"}}}]}},"sorts":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"attribute":{"type":"string","description":"A slug or ID to identify the attribute to sort by."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","attribute"],"description":"Sort by attribute"},{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"path":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","description":"The slug or ID of the object e.g. \"people\"."},{"type":"string","description":"A slug or ID to identify the attribute to sort by."}]},"minItems":2,"maxItems":2},"description":"You may use the `path` property to traverse record reference attributes and parent records on list entries. `path` accepts an array of tuples where the first element of each tuple is the slug or ID of a list/object, and the second element is the slug or ID of an attribute on that list/object. The first element of the first tuple must correspond to the list or object that you are querying. For example, if you wanted to sort by the name of the parent record (a company) on a list with the slug \"sales\", you would pass the value `[['sales', 'parent_record'], ['companies', 'name']]`."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","path"],"description":"Sort by path"}]},"description":"An object used to sort results. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","example":[{"direction":"asc","attribute":"domains","field":"domain"}]},"limit":{"type":"number","description":"The maximum number of results to return. Defaults to 500. See the [full guide to pagination here](/rest-api/guides/pagination).","example":500},"offset":{"type":"number","description":"The number of results to skip over before returning. Defaults to 0. See the [full guide to pagination here](/rest-api/guides/pagination).","example":0}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"team":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"last_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"last_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}},"strongest_connection_user":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"strongest_connection_strength_legacy":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"next_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"first_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"strongest_connection_strength":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"last_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"created_at":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `domains` or `name`) can be used, including custom attribute slugs.","example":{"domains":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"domain":"attio.com","root_domain":"attio.com","attribute_type":"domain"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Attio","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Customer relationship magic","attribute_type":"text"}],"team":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"121e50c2-65a3-449e-8397-c4d083d1e2e4","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"country_code":"GB","line_1":null,"line_2":null,"line_3":null,"line_4":null,"locality":"London","region":null,"latitude":null,"longitude":null,"postcode":null,"attribute_type":"location"}],"categories":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"B2B","is_archived":false},"attribute_type":"select"}],"logo_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"foundation_date":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01","attribute_type":"date"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"estimated_arr_usd":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"5678c8c4-34b1-42b6-9e4c-4db8baa58u7f","option_id":"g73565a9-94f3-410f-bb29-78287bc1c715"},"title":"$500M-$1B","is_archived":false},"attribute_type":"select"}],"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"employee_range":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"8264c8c4-34b1-42b6-9e4c-4db8baa58d6b","option_id":"gh65s5a9-94f3-410f-bb29-78287bc1c856"},"title":"51-250","is_archived":false},"attribute_type":"select"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/attio","attribute_type":"text"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/attio","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/attio","attribute_type":"text"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/attio","attribute_type":"text"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/attio","attribute_type":"text"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2022-07-11T11:51:47.182000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}]}}},"required":["id","created_at","web_url","values"]}}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["filter_error"]},"message":{"type":"string","example":"Error in filter."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"The referenced object was not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/companies/records":{"post":{"summary":"Create a company record","description":"Creates a new company record. This endpoint will throw on conflicts of unique attributes, like `domains`. If you would prefer to update company records on conflicts, please use the Assert company record endpoint instead. Please note, the `logo_url` attribute cannot currently be set via the API.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Companies"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","description":"The full domain of the website.","example":"app.attio.com"}}}},"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"}},"required":["line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42}},"required":["value"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["value"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"team":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard company attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"domains":["attio.com"],"name":"Attio","description":"Customer relationship magic","team":["alice@attio.com"],"primary_location":"1 Infinite Loop, Cupertino, CA, 95014, US"}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"team":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"last_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"last_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}},"strongest_connection_user":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"strongest_connection_strength_legacy":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"next_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"first_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"strongest_connection_strength":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"last_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"created_at":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `domains` or `name`) can be used, including custom attribute slugs.","example":{"domains":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"domain":"attio.com","root_domain":"attio.com","attribute_type":"domain"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Attio","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Customer relationship magic","attribute_type":"text"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01T15:00:00.000000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"twitter":[],"team":[],"primary_location":[],"last_email_interaction":[],"categories":[],"logo_url":[],"twitter_follower_count":[],"last_calendar_interaction":[],"linkedin":[],"foundation_date":[],"strongest_connection_user":[],"estimated_arr_usd":[],"strongest_connection_strength_legacy":[],"next_calendar_interaction":[],"employee_range":[],"first_interaction":[],"angellist":[],"facebook":[],"first_email_interaction":[],"strongest_connection_strength":[],"first_calendar_interaction":[],"instagram":[],"last_interaction":[]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"Cannot find select attribute with select option title \"In Progress\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"put":{"summary":"Assert a company record","description":"Use this endpoint to create or update company records, using a unique attribute to search for existing companies (for example, the `domains` attribute). If a company is found with the same value for the matching attribute, that company will be updated. If no company with the same value for the matching attribute is found, a new company will be created instead. If you would like to avoid matching, please use the Create company endpoint.\n\n\nIf the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Companies"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"The ID or slug of the attribute to use to check if a company already exists. The attribute must be unique. For company records, `domains` is the only unique attribute.","example":"domains"},"required":true,"name":"matching_attribute","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","description":"The full domain of the website.","example":"app.attio.com"}}}},"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"}},"required":["line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42}},"required":["value"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["value"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"team":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard company attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"domains":["attio.com"],"name":"Attio","description":"Customer relationship magic","team":["alice@attio.com"],"primary_location":"1 Infinite Loop, Cupertino, CA, 95014, US"}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"team":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"last_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"last_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}},"strongest_connection_user":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"strongest_connection_strength_legacy":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"next_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"first_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"strongest_connection_strength":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"last_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"created_at":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `domains` or `name`) can be used, including custom attribute slugs.","example":{"domains":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"domain":"attio.com","root_domain":"attio.com","attribute_type":"domain"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Attio","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Customer relationship magic","attribute_type":"text"}],"team":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"121e50c2-65a3-449e-8397-c4d083d1e2e4","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"country_code":"GB","line_1":null,"line_2":null,"line_3":null,"line_4":null,"locality":"London","region":null,"latitude":null,"longitude":null,"postcode":null,"attribute_type":"location"}],"categories":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"B2B","is_archived":false},"attribute_type":"select"}],"logo_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"foundation_date":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01","attribute_type":"date"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"estimated_arr_usd":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"5678c8c4-34b1-42b6-9e4c-4db8baa58u7f","option_id":"g73565a9-94f3-410f-bb29-78287bc1c715"},"title":"$500M-$1B","is_archived":false},"attribute_type":"select"}],"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"employee_range":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"8264c8c4-34b1-42b6-9e4c-4db8baa58d6b","option_id":"gh65s5a9-94f3-410f-bb29-78287bc1c856"},"title":"51-250","is_archived":false},"attribute_type":"select"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/attio","attribute_type":"text"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/attio","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/attio","attribute_type":"text"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/attio","attribute_type":"text"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/attio","attribute_type":"text"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2022-07-11T11:51:47.182000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"No attribute was found for matching_attribute slug/ID \"my-attribute\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/companies/records/{record_id}":{"get":{"summary":"Get a company record","description":"Gets a single company record by its `record_id`.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Companies"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the company record to fetch.","example":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"team":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"last_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"last_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}},"strongest_connection_user":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"strongest_connection_strength_legacy":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"next_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"first_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"strongest_connection_strength":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"last_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"created_at":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `domains` or `name`) can be used, including custom attribute slugs.","example":{"domains":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"domain":"attio.com","root_domain":"attio.com","attribute_type":"domain"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Attio","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Customer relationship magic","attribute_type":"text"}],"team":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"121e50c2-65a3-449e-8397-c4d083d1e2e4","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"country_code":"GB","line_1":null,"line_2":null,"line_3":null,"line_4":null,"locality":"London","region":null,"latitude":null,"longitude":null,"postcode":null,"attribute_type":"location"}],"categories":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"B2B","is_archived":false},"attribute_type":"select"}],"logo_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"foundation_date":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01","attribute_type":"date"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"estimated_arr_usd":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"5678c8c4-34b1-42b6-9e4c-4db8baa58u7f","option_id":"g73565a9-94f3-410f-bb29-78287bc1c715"},"title":"$500M-$1B","is_archived":false},"attribute_type":"select"}],"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"employee_range":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"8264c8c4-34b1-42b6-9e4c-4db8baa58d6b","option_id":"gh65s5a9-94f3-410f-bb29-78287bc1c856"},"title":"51-250","is_archived":false},"attribute_type":"select"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/attio","attribute_type":"text"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/attio","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/attio","attribute_type":"text"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/attio","attribute_type":"text"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/attio","attribute_type":"text"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2022-07-11T11:51:47.182000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"patch":{"summary":"Update a company record","description":"Use this endpoint to update company records by `record_id`. If the update payload includes multiselect attributes, the values supplied will be created and prepended to the list of values that already exist (if any). Use the [Assert company endpoint](/rest-api/endpoint-reference/standard-objects/companies/assert-a-company-record) to overwrite or remove multiselect attribute values. Please note, the `logo_url` attribute cannot currently be updated via the API.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Companies"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the company record to update.","example":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},"required":true,"name":"record_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","description":"The full domain of the website.","example":"app.attio.com"}}}},"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"}},"required":["line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42}},"required":["value"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["value"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string","minLength":1,"description":"The UUID or select option title identifying the selected select option.","example":"Medium"}},"required":["option"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"team":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard company attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"domains":["attio.com"],"name":"Attio","description":"Customer relationship magic","team":["alice@attio.com"],"primary_location":"1 Infinite Loop, Cupertino, CA, 95014, US"}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"description":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"team":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_location":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false}},"last_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"logo_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"twitter_follower_count":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"last_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"linkedin":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"foundation_date":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}},"strongest_connection_user":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"estimated_arr_usd":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"strongest_connection_strength_legacy":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]}},"next_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"employee_range":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"angellist":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"facebook":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"first_email_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"strongest_connection_strength":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false}},"first_calendar_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"instagram":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"last_interaction":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false}},"created_at":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `domains` or `name`) can be used, including custom attribute slugs.","example":{"domains":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"domain":"attio.com","root_domain":"attio.com","attribute_type":"domain"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Attio","attribute_type":"text"}],"description":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"value":"Customer relationship magic","attribute_type":"text"}],"team":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"121e50c2-65a3-449e-8397-c4d083d1e2e4","attribute_type":"record-reference"}],"primary_location":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"country_code":"GB","line_1":null,"line_2":null,"line_3":null,"line_4":null,"locality":"London","region":null,"latitude":null,"longitude":null,"postcode":null,"attribute_type":"location"}],"categories":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"B2B","is_archived":false},"attribute_type":"select"}],"logo_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6","attribute_type":"text"}],"twitter_follower_count":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":100,"attribute_type":"number"}],"foundation_date":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2023-01-01","attribute_type":"date"}],"strongest_connection_user":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}],"estimated_arr_usd":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"5678c8c4-34b1-42b6-9e4c-4db8baa58u7f","option_id":"g73565a9-94f3-410f-bb29-78287bc1c715"},"title":"$500M-$1B","is_archived":false},"attribute_type":"select"}],"strongest_connection_strength_legacy":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":54.725113205693695,"attribute_type":"number"}],"employee_range":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"8264c8c4-34b1-42b6-9e4c-4db8baa58d6b","option_id":"gh65s5a9-94f3-410f-bb29-78287bc1c856"},"title":"51-250","is_archived":false},"attribute_type":"select"}],"twitter":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://x.com/attio","attribute_type":"text"}],"angellist":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://angellist.com/attio","attribute_type":"text"}],"facebook":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://facebook.com/attio","attribute_type":"text"}],"linkedin":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://linkedin.com/in/attio","attribute_type":"text"}],"instagram":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://instagram.com/attio","attribute_type":"text"}],"strongest_connection_strength":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"option":{"id":{"workspace_id":"ca10906c-6785-464e-bb6c-b003e63c6a18","object_id":"cf49cf53-dbb4-4d18-87fc-28aba21d7a49","attribute_id":"7914c8c4-34b1-42b6-9e4c-4db8baa58bfa","option_id":"e37175a9-94f3-410f-bb29-78287bc1c444"},"title":"Very strong","is_archived":false},"attribute_type":"select"}],"last_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_email_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"first_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"next_calendar_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"last_interaction":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"interaction_type":"email","interacted_at":"2023-01-01T15:00:00.000000000Z","owner_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"attribute_type":"interaction"}],"created_at":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"2022-07-11T11:51:47.182000000Z","attribute_type":"timestamp"}],"created_by":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64","attribute_type":"actor-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["missing_value"]},"message":{"type":"string","example":"Required value for attribute with ID \"41252299-f8c7-4b5e-99c9-4ff8321d2f96\" was not provided."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"delete":{"summary":"Delete a company record","description":"Deletes a single company record by ID.\n\nRequired scopes: `object_configuration:read`, `record_permission:read-write`.","tags":["Companies"],"security":[{"oauth2":["object_configuration:read","record_permission:read-write"]}],"parameters":[{"schema":{"type":"string","description":"The UUID of the company record to delete.","example":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{},"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/companies/records/{record_id}/attributes/{attribute}/values":{"get":{"summary":"List company record attribute values","description":"Gets all values for a given attribute on a company record. Historic values can be queried using the `show_historic` query param. Historic values cannot be queried on COMINT (Communication Intelligence) or enriched attributes and the endpoint will return a 400 error if this is attempted. Historic values are sorted from oldest to newest (by `active_from`). Some attributes are subject to billing status and will return an empty array of values if theworkspace being queried does not have the required billing flag enabled.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Companies"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the company record to fetch attribute values for.","example":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"string","description":"A UUID or slug to identify the attribute you want to query values on.","example":"domains"},"required":true,"name":"attribute","in":"path"},{"schema":{"type":"boolean","description":"If `true`, the endpoint will return all historic values for the attribute. If `false`, the endpoint will only return the currently active value(s). Defaults to `false`. Cannot be set to `true` for COMINT attributes or enriched attributes on people/company objects.","example":true,"default":false},"required":false,"name":"show_historic","in":"query"},{"schema":{"type":"integer","description":"The maximum number of results to return. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"boolean","description":"A boolean representing whether the checkbox is checked or not. The string values 'true' and 'false' are also accepted.","example":true},"attribute_type":{"type":"string","enum":["checkbox"],"description":"The attribute type of the value.","example":"checkbox"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"A number between 0 and 5 (inclusive) to represent a star rating.","example":3},"attribute_type":{"type":"string","enum":["rating"],"description":"The attribute type of the value.","example":"rating"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}]}}},"required":["data"],"description":"Success","example":{"data":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"workspace-member","id":"a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"},"domain":"attio.com","root_domain":"attio.com","attribute_type":"domain"}]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["validation_type"]},"message":{"type":"string","example":"Cannot set show_historic param to true when querying a COMINT attribute."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Attribute with slug/ID \"my-attribute\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/companies/records/{record_id}/entries":{"get":{"summary":"List company record entries","description":"List all entries, across all lists, for which this company record is the parent.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`, `list_entry:read`.","tags":["Companies"],"security":[{"oauth2":["record_permission:read","object_configuration:read","list_entry:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the company record to fetch entries for.","example":"99a03ff3-0435-47da-95cc-76b2caeb4dab"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"integer","description":"The maximum number of results to return. The default is `100` and the maximum is `1000`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. The default is `0`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"list_id":{"type":"string","format":"uuid","description":"A UUID identifying the list that this company record is in.","example":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"},"list_api_slug":{"type":"string","description":"A human-readable slug for the list for use in URLs and responses.","example":"sales-prospects"},"entry_id":{"type":"string","format":"uuid","description":"A UUID identifying this entry on the list.","example":"2e6e29ea-c4e0-4f44-842d-78a891f8c156"},"created_at":{"type":"string","description":"When this entry was created.","example":"2022-11-21T13:22:49.061281000Z"}},"required":["list_id","list_api_slug","entry_id","created_at"]}}},"required":["data"],"description":"Success"}}}}}}},"/v2/objects/users/records/query":{"post":{"summary":"List user records","description":"Lists user records, with the option to filter and sort results.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Users"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"object","description":"An object used to filter results to a subset of records. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","additionalProperties":true,"example":{"$and":[{"user_id":{"value":{"$eq":"123"}}}]}},"sorts":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"attribute":{"type":"string","description":"A slug or ID to identify the attribute to sort by."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","attribute"],"description":"Sort by attribute"},{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"path":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","description":"The slug or ID of the object e.g. \"people\"."},{"type":"string","description":"A slug or ID to identify the attribute to sort by."}]},"minItems":2,"maxItems":2},"description":"You may use the `path` property to traverse record reference attributes and parent records on list entries. `path` accepts an array of tuples where the first element of each tuple is the slug or ID of a list/object, and the second element is the slug or ID of an attribute on that list/object. The first element of the first tuple must correspond to the list or object that you are querying. For example, if you wanted to sort by the name of the parent record (a company) on a list with the slug \"sales\", you would pass the value `[['sales', 'parent_record'], ['companies', 'name']]`."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","path"],"description":"Sort by path"}]},"description":"An object used to sort results. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","example":[{"direction":"asc","attribute":"name","field":"last_name"}]},"limit":{"type":"number","description":"The maximum number of results to return. Defaults to 500. See the [full guide to pagination here](/rest-api/guides/pagination).","example":500},"offset":{"type":"number","description":"The number of results to skip over before returning. Defaults to 0. See the [full guide to pagination here](/rest-api/guides/pagination).","example":0}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"person":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"user_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"workspace":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `person` or `primary_email_address`) can be used, including custom attribute slugs.","example":{"person":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d","attribute_type":"record-reference"}],"primary_email_address":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"person@company.com","email_address":"person@company.com","email_domain":"company.com","email_root_domain":"company.com","email_local_specifier":"person","attribute_type":"email-address"}],"user_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"workspace":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["filter_error"]},"message":{"type":"string","example":"Error in filter."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"The referenced object was not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/users/records":{"post":{"summary":"Create a user record","description":"Creates a new user record. This endpoint will throw on conflicts of unique attributes, like `primary_email_address`. If you would prefer to update user records on conflicts, please use the Assert user record endpoint instead. Please note, the `avatar_url` attribute cannot currently be set via the API.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Users"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"person":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"email_address":{"type":"string","description":"An email address string","example":"alice@app.attio.com"}}}},"user_id":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"workspace":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard user attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"user_id":"123","primary_email_address":"person@company.com","person":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"workspace":[{"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040"}]}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"person":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"user_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"workspace":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `person` or `primary_email_address`) can be used, including custom attribute slugs.","example":{"person":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d","attribute_type":"record-reference"}],"primary_email_address":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"person@company.com","email_address":"person@company.com","email_domain":"company.com","email_root_domain":"company.com","email_local_specifier":"person","attribute_type":"email-address"}],"user_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"workspace":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"Cannot find select attribute with select option title \"In Progress\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"put":{"summary":"Assert a user record","description":"Use this endpoint to create or update user records, using a unique attribute to search for existing users (for example the `primary_email_address` attribute). If a user is found with the same value for the matching attribute, that user will be updated, otherwise a new user will be created instead. If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Users"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"The ID or slug of the attribute to use to check if a user already exists. The attribute must be unique. For user records, you can use `primary_email_address` or `user_id`, or any additional custom attribute with a unique constraint.","example":"primary_email_address"},"required":true,"name":"matching_attribute","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"person":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"email_address":{"type":"string","description":"An email address string","example":"alice@app.attio.com"}}}},"user_id":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"workspace":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard user attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"user_id":"123","primary_email_address":"person@company.com","person":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"workspace":[{"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040"}]}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"person":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"user_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"workspace":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `person` or `primary_email_address`) can be used, including custom attribute slugs.","example":{"person":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d","attribute_type":"record-reference"}],"primary_email_address":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"person@company.com","email_address":"person@company.com","email_domain":"company.com","email_root_domain":"company.com","email_local_specifier":"person","attribute_type":"email-address"}],"user_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"workspace":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"No attribute was found for matching_attribute slug/ID \"my-attribute\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/users/records/{record_id}":{"get":{"summary":"Get a user record","description":"Gets a single user record by its `record_id`.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Users"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the user record to fetch.","example":"5e3fb280-007b-495a-a530-9354bde01de1"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"person":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"user_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"workspace":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `person` or `primary_email_address`) can be used, including custom attribute slugs.","example":{"person":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d","attribute_type":"record-reference"}],"primary_email_address":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"person@company.com","email_address":"person@company.com","email_domain":"company.com","email_root_domain":"company.com","email_local_specifier":"person","attribute_type":"email-address"}],"user_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"workspace":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"patch":{"summary":"Update a user Record","description":"Use this endpoint to update user records by `record_id`. If the update payload includes multiselect attributes, the values supplied will be created and prepended to the list of values that already exist (if any). Use the [Assert user endpoint](/reference/put_v2-objects-users-records) to overwrite or remove multiselect attribute values. Please note, the `avatar_url` attribute cannot currently be updated via the API.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Users"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the user record to update.","example":"5e3fb280-007b-495a-a530-9354bde01de1"},"required":true,"name":"record_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"person":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"email_address":{"type":"string","description":"An email address string","example":"alice@app.attio.com"}}}},"user_id":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"workspace":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard user attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"user_id":"123","primary_email_address":"person@company.com","person":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"workspace":[{"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040"}]}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"person":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"primary_email_address":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]}},"user_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"workspace":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `person` or `primary_email_address`) can be used, including custom attribute slugs.","example":{"person":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d","attribute_type":"record-reference"}],"primary_email_address":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"original_email_address":"person@company.com","email_address":"person@company.com","email_domain":"company.com","email_root_domain":"company.com","email_local_specifier":"person","attribute_type":"email-address"}],"user_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"workspace":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"workspaces","target_record_id":"72ef5feaf-4919-4208-b332-1339ab8ba040","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["missing_value"]},"message":{"type":"string","example":"Required value for attribute with ID \"41252299-f8c7-4b5e-99c9-4ff8321d2f96\" was not provided."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"delete":{"summary":"Delete a user record","description":"Deletes a single user record by ID.\n\nRequired scopes: `object_configuration:read`, `record_permission:read-write`.","tags":["Users"],"security":[{"oauth2":["object_configuration:read","record_permission:read-write"]}],"parameters":[{"schema":{"type":"string","description":"The UUID of the user record to delete.","example":"5e3fb280-007b-495a-a530-9354bde01de1"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{},"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/users/records/{record_id}/attributes/{attribute}/values":{"get":{"summary":"List user record attribute values","description":"Gets all values for a given attribute on a user record. Historic values can be queried using the `show_historic` query param. Historic values are sorted from oldest to newest (by `active_from`).\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Users"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the user record to fetch attribute values for.","example":"5e3fb280-007b-495a-a530-9354bde01de1"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"string","description":"A UUID or slug to identify the attribute you want to query values on.","example":"primary_email_address"},"required":true,"name":"attribute","in":"path"},{"schema":{"type":"boolean","description":"If `true`, the endpoint will return all historic values for the attribute. If `false`, the endpoint will only return the currently active value(s). Defaults to `false`. Cannot be set to `true` for COMINT attributes or enriched attributes on people/company objects.","example":true,"default":false},"required":false,"name":"show_historic","in":"query"},{"schema":{"type":"integer","description":"The maximum number of results to return. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"boolean","description":"A boolean representing whether the checkbox is checked or not. The string values 'true' and 'false' are also accepted.","example":true},"attribute_type":{"type":"string","enum":["checkbox"],"description":"The attribute type of the value.","example":"checkbox"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"A number between 0 and 5 (inclusive) to represent a star rating.","example":3},"attribute_type":{"type":"string","enum":["rating"],"description":"The attribute type of the value.","example":"rating"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}]}}},"required":["data"],"description":"Success","example":{"data":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d","attribute_type":"record-reference"}]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["validation_type"]},"message":{"type":"string","example":"Cannot set show_historic param to true when querying a COMINT attribute."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Attribute with slug/ID \"my-attribute\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/users/records/{record_id}/entries":{"get":{"summary":"List user record entries","description":"List all entries, across all lists, for which this user record is the parent.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`, `list_entry:read`.","tags":["Users"],"security":[{"oauth2":["record_permission:read","object_configuration:read","list_entry:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the user record to fetch entries for.","example":"5e3fb280-007b-495a-a530-9354bde01de1"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"integer","description":"The maximum number of results to return. The default is `100` and the maximum is `1000`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. The default is `0`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"list_id":{"type":"string","format":"uuid","description":"A UUID identifying the list that this record is in.","example":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"},"list_api_slug":{"type":"string","description":"A human-readable slug for the list for use in URLs and responses.","example":"hiring-engineering"},"entry_id":{"type":"string","format":"uuid","description":"A UUID identifying this entry on the list.","example":"2e6e29ea-c4e0-4f44-842d-78a891f8c156"},"created_at":{"type":"string","description":"When this entry was created.","example":"2022-11-21T13:22:49.061281000Z"}},"required":["list_id","list_api_slug","entry_id","created_at"]}}},"required":["data"],"description":"Success"}}}}}}},"/v2/objects/deals/records":{"put":{"summary":"Assert a deal record","description":"Use this endpoint to create or update deal records, using a unique attribute to search for existing deals. By default, deals do not have a unique attribute, so you should add your own attribute with a unique constraint to use this API. If a deal is found with the same value for the matching attribute, that deal will be updated, otherwise a new deal will be created instead. If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Deals"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"The ID or slug of the attribute to use to check if a deal already exists. The attribute must be unique. There is no unique attribute on deals by default, so you should add your own.","example":"custom_deal_attribute"},"required":true,"name":"matching_attribute","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","minLength":1,"description":"The UUID or status title identifying the selected status.","example":"In Progress"}},"required":["status"],"additionalProperties":false}},"owner":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"referenced_actor_type":{"type":"string","enum":["workspace-member"],"description":"The type of the referenced actor. Currently, only workspace members can be written into actor reference attributes. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":"string","format":"uuid","description":"The ID of the referenced Actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"required":["referenced_actor_type","referenced_actor_id"],"additionalProperties":false},{"type":"object","properties":{"workspace_member_email_address":{"type":"string","description":"Workspace member actors can be referenced by email address as well as actor ID.","example":"alice@attio.com"}},"required":["workspace_member_email_address"],"additionalProperties":false}]}},"value":{"type":"array","items":{"type":"object","properties":{"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99}},"required":["currency_value"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"associated_company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard deal attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"name":"Contract with Fundstack","stage":"In Progress","owner":"person@company.com","value":4200,"associated_people":[{"target_object":"people","email_addresses":[{"email_address":"person@company.com"}]}],"associated_company":{"target_object":"companies","domains":[{"domain":"company.com"}]}}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false}},"owner":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"value":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"associated_company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `name` or `stage`) can be used, including custom attribute slugs.","example":{"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Contract with Fundstack","attribute_type":"text"}],"stage":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"status":{"title":"In Progress","id":{"workspace_id":"14beef7a-99f7-4534-a87e-70b564330a4c","object_id":"97052eb9-e65e-443f-a297-f2d9a4a7f795","attribute_id":"41252299-f8c7-4b5e-99c9-4ff8321d2f96","status_id":"11f07f01-c10f-4e05-a522-33e050bc52ee"},"is_archived":false,"celebration_enabled":false,"target_time_in_status":null},"attribute_type":"status"}],"owner":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","attribute_type":"actor-reference"}],"value":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"currency_value":4200,"currency_code":"USD","attribute_type":"currency"}],"associated_people":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}],"associated_company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"No attribute was found for matching_attribute slug/ID \"my-attribute\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"post":{"summary":"Create a deal record","description":"Creates a new deal record. This endpoint will throw on conflicts of unique attributes, if defined. If you would prefer to update deal records on conflicts, please use the Assert deal record endpoint instead.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Deals"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","minLength":1,"description":"The UUID or status title identifying the selected status.","example":"In Progress"}},"required":["status"],"additionalProperties":false}},"owner":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"referenced_actor_type":{"type":"string","enum":["workspace-member"],"description":"The type of the referenced actor. Currently, only workspace members can be written into actor reference attributes. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":"string","format":"uuid","description":"The ID of the referenced Actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"required":["referenced_actor_type","referenced_actor_id"],"additionalProperties":false},{"type":"object","properties":{"workspace_member_email_address":{"type":"string","description":"Workspace member actors can be referenced by email address as well as actor ID.","example":"alice@attio.com"}},"required":["workspace_member_email_address"],"additionalProperties":false}]}},"value":{"type":"array","items":{"type":"object","properties":{"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99}},"required":["currency_value"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"associated_company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard deal attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"name":"Contract with Fundstack","stage":"In Progress","owner":"person@company.com","value":4200,"associated_people":[{"target_object":"people","email_addresses":[{"email_address":"person@company.com"}]}],"associated_company":{"target_object":"companies","domains":[{"domain":"company.com"}]}}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false}},"owner":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"value":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"associated_company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `name` or `stage`) can be used, including custom attribute slugs.","example":{"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Contract with Fundstack","attribute_type":"text"}],"stage":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"status":{"title":"In Progress","id":{"workspace_id":"14beef7a-99f7-4534-a87e-70b564330a4c","object_id":"97052eb9-e65e-443f-a297-f2d9a4a7f795","attribute_id":"41252299-f8c7-4b5e-99c9-4ff8321d2f96","status_id":"11f07f01-c10f-4e05-a522-33e050bc52ee"},"is_archived":false,"celebration_enabled":false,"target_time_in_status":null},"attribute_type":"status"}],"owner":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","attribute_type":"actor-reference"}],"value":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"currency_value":4200,"currency_code":"USD","attribute_type":"currency"}],"associated_people":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}],"associated_company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"Cannot find select attribute with select option title \"In Progress\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/deals/records/{record_id}":{"delete":{"summary":"Delete a deal record","description":"Deletes a single deal record by ID.\n\nRequired scopes: `object_configuration:read`, `record_permission:read-write`.","tags":["Deals"],"security":[{"oauth2":["object_configuration:read","record_permission:read-write"]}],"parameters":[{"schema":{"type":"string","description":"The UUID of the deal record to delete.","example":"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{},"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"get":{"summary":"Get a deal record","description":"Gets a single deal record by its `record_id`.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Deals"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the deal record to fetch.","example":"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false}},"owner":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"value":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"associated_company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `name` or `stage`) can be used, including custom attribute slugs.","example":{"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Contract with Fundstack","attribute_type":"text"}],"stage":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"status":{"title":"In Progress","id":{"workspace_id":"14beef7a-99f7-4534-a87e-70b564330a4c","object_id":"97052eb9-e65e-443f-a297-f2d9a4a7f795","attribute_id":"41252299-f8c7-4b5e-99c9-4ff8321d2f96","status_id":"11f07f01-c10f-4e05-a522-33e050bc52ee"},"is_archived":false,"celebration_enabled":false,"target_time_in_status":null},"attribute_type":"status"}],"owner":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","attribute_type":"actor-reference"}],"value":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"currency_value":4200,"currency_code":"USD","attribute_type":"currency"}],"associated_people":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}],"associated_company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"patch":{"summary":"Update a deal record","description":"Use this endpoint to update deal records by `record_id`. If the update payload includes multiselect attributes, the values supplied will be created and prepended to the list of values that already exist (if any). Use the [Assert deal endpoint](/rest-api/endpoint-reference/standard-objects/deals/assert-a-deal-record) to overwrite or remove multiselect attribute values.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Deals"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the deal record to update.","example":"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"},"required":true,"name":"record_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","minLength":1,"description":"The UUID or status title identifying the selected status.","example":"In Progress"}},"required":["status"],"additionalProperties":false}},"owner":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"referenced_actor_type":{"type":"string","enum":["workspace-member"],"description":"The type of the referenced actor. Currently, only workspace members can be written into actor reference attributes. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":"string","format":"uuid","description":"The ID of the referenced Actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"required":["referenced_actor_type","referenced_actor_id"],"additionalProperties":false},{"type":"object","properties":{"workspace_member_email_address":{"type":"string","description":"Workspace member actors can be referenced by email address as well as actor ID.","example":"alice@attio.com"}},"required":["workspace_member_email_address"],"additionalProperties":false}]}},"value":{"type":"array","items":{"type":"object","properties":{"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99}},"required":["currency_value"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"associated_company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard deal attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"name":"Contract with Fundstack","stage":"In Progress","owner":"person@company.com","value":4200,"associated_people":[{"target_object":"people","email_addresses":[{"email_address":"person@company.com"}]}],"associated_company":{"target_object":"companies","domains":[{"domain":"company.com"}]}}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false}},"owner":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"value":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"associated_company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `name` or `stage`) can be used, including custom attribute slugs.","example":{"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Contract with Fundstack","attribute_type":"text"}],"stage":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"status":{"title":"In Progress","id":{"workspace_id":"14beef7a-99f7-4534-a87e-70b564330a4c","object_id":"97052eb9-e65e-443f-a297-f2d9a4a7f795","attribute_id":"41252299-f8c7-4b5e-99c9-4ff8321d2f96","status_id":"11f07f01-c10f-4e05-a522-33e050bc52ee"},"is_archived":false,"celebration_enabled":false,"target_time_in_status":null},"attribute_type":"status"}],"owner":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","attribute_type":"actor-reference"}],"value":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"currency_value":4200,"currency_code":"USD","attribute_type":"currency"}],"associated_people":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}],"associated_company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["missing_value"]},"message":{"type":"string","example":"Required value for attribute with ID \"41252299-f8c7-4b5e-99c9-4ff8321d2f96\" was not provided."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/deals/records/{record_id}/attributes/{attribute}/values":{"get":{"summary":"List deal record attribute values","description":"Gets all values for a given attribute on a deal record. Historic values can be queried using the `show_historic` query param. Historic values are sorted from oldest to newest (by `active_from`).\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Deals"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the deal record to fetch attribute values for.","example":"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"string","description":"A UUID or slug to identify the attribute you want to query values on.","example":"owner"},"required":true,"name":"attribute","in":"path"},{"schema":{"type":"boolean","description":"If `true`, the endpoint will return all historic values for the attribute. If `false`, the endpoint will only return the currently active value(s). Defaults to `false`. Cannot be set to `true` for COMINT attributes or enriched attributes on people/company objects.","example":true,"default":false},"required":false,"name":"show_historic","in":"query"},{"schema":{"type":"integer","description":"The maximum number of results to return. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"boolean","description":"A boolean representing whether the checkbox is checked or not. The string values 'true' and 'false' are also accepted.","example":true},"attribute_type":{"type":"string","enum":["checkbox"],"description":"The attribute type of the value.","example":"checkbox"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"A number between 0 and 5 (inclusive) to represent a star rating.","example":3},"attribute_type":{"type":"string","enum":["rating"],"description":"The attribute type of the value.","example":"rating"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}]}}},"required":["data"],"description":"Success","example":{"data":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d","attribute_type":"record-reference"}]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["validation_type"]},"message":{"type":"string","example":"Cannot set show_historic param to true when querying a COMINT attribute."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Attribute with slug/ID \"my-attribute\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/deals/records/{record_id}/entries":{"get":{"summary":"List deal record entries","description":"List all entries, across all lists, for which this deal record is the parent.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`, `list_entry:read`.","tags":["Deals"],"security":[{"oauth2":["record_permission:read","object_configuration:read","list_entry:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the deal record to fetch entries for.","example":"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"integer","description":"The maximum number of results to return. The default is `100` and the maximum is `1000`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. The default is `0`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"list_id":{"type":"string","format":"uuid","description":"A UUID identifying the list that this record is in.","example":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"},"list_api_slug":{"type":"string","description":"A human-readable slug for the list for use in URLs and responses.","example":"hiring-engineering"},"entry_id":{"type":"string","format":"uuid","description":"A UUID identifying this entry on the list.","example":"2e6e29ea-c4e0-4f44-842d-78a891f8c156"},"created_at":{"type":"string","description":"When this entry was created.","example":"2022-11-21T13:22:49.061281000Z"}},"required":["list_id","list_api_slug","entry_id","created_at"]}}},"required":["data"],"description":"Success"}}}}}}},"/v2/objects/deals/records/query":{"post":{"summary":"List deal records","description":"Lists deal records, with the option to filter and sort results.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Deals"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"object","description":"An object used to filter results to a subset of records. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","additionalProperties":true,"example":{"$and":[{"path":[["deals","associated_company"],["companies","domains"]],"constraints":{"domain":"fundstack.com"}}]}},"sorts":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"attribute":{"type":"string","description":"A slug or ID to identify the attribute to sort by."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","attribute"],"description":"Sort by attribute"},{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"path":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","description":"The slug or ID of the object e.g. \"people\"."},{"type":"string","description":"A slug or ID to identify the attribute to sort by."}]},"minItems":2,"maxItems":2},"description":"You may use the `path` property to traverse record reference attributes and parent records on list entries. `path` accepts an array of tuples where the first element of each tuple is the slug or ID of a list/object, and the second element is the slug or ID of an attribute on that list/object. The first element of the first tuple must correspond to the list or object that you are querying. For example, if you wanted to sort by the name of the parent record (a company) on a list with the slug \"sales\", you would pass the value `[['sales', 'parent_record'], ['companies', 'name']]`."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","path"],"description":"Sort by path"}]},"description":"An object used to sort results. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","example":[{"direction":"asc","attribute":"name","field":"last_name"}]},"limit":{"type":"number","description":"The maximum number of results to return. Defaults to 500. See the [full guide to pagination here](/rest-api/guides/pagination).","example":500},"offset":{"type":"number","description":"The number of results to skip over before returning. Defaults to 0. See the [full guide to pagination here](/rest-api/guides/pagination).","example":0}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"stage":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false}},"owner":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false}},"value":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false}},"associated_people":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"associated_company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `name` or `stage`) can be used, including custom attribute slugs.","example":{"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Contract with Fundstack","attribute_type":"text"}],"stage":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"status":{"title":"In Progress","id":{"workspace_id":"14beef7a-99f7-4534-a87e-70b564330a4c","object_id":"97052eb9-e65e-443f-a297-f2d9a4a7f795","attribute_id":"41252299-f8c7-4b5e-99c9-4ff8321d2f96","status_id":"11f07f01-c10f-4e05-a522-33e050bc52ee"},"is_archived":false,"celebration_enabled":false,"target_time_in_status":null},"attribute_type":"status"}],"owner":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"referenced_actor_type":"workspace-member","referenced_actor_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","attribute_type":"actor-reference"}],"value":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"currency_value":4200,"currency_code":"USD","attribute_type":"currency"}],"associated_people":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"people","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}],"associated_company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"bf071e1f-6035-429d-b874-d83ea64ea13b","attribute_type":"record-reference"}]}}},"required":["id","created_at","web_url","values"]}}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["filter_error"]},"message":{"type":"string","example":"Error in filter."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"The referenced object was not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/workspaces/records":{"put":{"summary":"Assert a workspace record","description":"Use this endpoint to create or update workspace records, using a unique attribute to search for existing workspaces (for example the `workspace_id` attribute). If a workspace is found with the same value for the matching attribute, that workspace will be updated, otherwise a new workspace will be created instead. If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Workspaces"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"The ID or slug of the attribute to use to check if a workspace already exists. The attribute must be unique. For workspace records, you can use `workspace_id`  or any additional custom attribute with a unique constraint.","example":"workspace_id"},"required":true,"name":"matching_attribute","in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"users":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard workspace attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"workspace_id":"123","name":"Customer.com","avatar_url":"https://example.com/avatar.png","users":[{"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1"}],"company":{"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab"}}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"users":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `workspace_id` or `name`) can be used, including custom attribute slugs.","example":{"workspace_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Fundstack","attribute_type":"text"}],"users":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1","attribute_type":"record-reference"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab","attribute_type":"record-reference"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://example.com/avatar.png","attribute_type":"text"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"No attribute was found for matching_attribute slug/ID \"my-attribute\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"post":{"summary":"Create a workspace record","description":"Creates a new workspace record. This endpoint will throw on conflicts of unique attributes, like `workspace_id`. If you would prefer to update workspace records on conflicts, please use the Assert workspace record endpoint instead.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Workspaces"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"users":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard workspace attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"workspace_id":"123","name":"Customer.com","avatar_url":"https://example.com/avatar.png","users":[{"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1"}],"company":{"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab"}}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"users":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `person` or `primary_email_address`) can be used, including custom attribute slugs.","example":{"workspace_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Fundstack","attribute_type":"text"}],"users":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1","attribute_type":"record-reference"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab","attribute_type":"record-reference"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://example.com/avatar.png","attribute_type":"text"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["value_not_found"]},"message":{"type":"string","example":"Cannot find select attribute with select option title \"In Progress\"."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/workspaces/records/{record_id}":{"delete":{"summary":"Delete a workspace record","description":"Deletes a single workspace record by ID.\n\nRequired scopes: `object_configuration:read`, `record_permission:read-write`.","tags":["Workspaces"],"security":[{"oauth2":["object_configuration:read","record_permission:read-write"]}],"parameters":[{"schema":{"type":"string","description":"The UUID of the workspace record to delete.","example":"72ef5feaf-4919-4208-b332-1339ab8ba040"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{},"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"get":{"summary":"Get a workspace record","description":"Gets a single workspace record by its `record_id`.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Workspaces"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the workspace record to fetch.","example":"72ef5feaf-4919-4208-b332-1339ab8ba040"},"required":true,"name":"record_id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"users":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `workspace_id` or `name`) can be used, including custom attribute slugs.","example":{"workspace_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Fundstack","attribute_type":"text"}],"users":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1","attribute_type":"record-reference"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab","attribute_type":"record-reference"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://example.com/avatar.png","attribute_type":"text"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Record with ID \"891dcbfc-9141-415d-9b2a-2238a6cc012d\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}},"patch":{"summary":"Update a workspace Record","description":"Use this endpoint to update workspace records by `record_id`. If the update payload includes multiselect attributes, the values supplied will be created and prepended to the list of values that already exist (if any). Use the [Assert workspace endpoint](/rest-api/endpoint-reference/standard-objects/workspaces/assert-a-workspace-record) to overwrite or remove multiselect attribute values.\n\nRequired scopes: `record_permission:read-write`, `object_configuration:read`.","tags":["Workspaces"],"security":[{"oauth2":["record_permission:read-write","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the workspace record to update.","example":"72ef5feaf-4919-4208-b332-1339ab8ba040"},"required":true,"name":"record_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}},"users":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"company":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target_object":{"type":"string","description":"A UUID or slug to identify the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}},"required":["target_object","target_record_id"],"additionalProperties":false},{"type":"object","example":{"target_object":"people","matching_attribute_id_123":[{"value":"matching_attribute_id_123"}]},"properties":{"target_object":{"type":"string","example":"people","description":"A UUID or slug to identify the object that the referenced record belongs to."},"[slug_or_id_of_matching_attribute]":{"type":"array","description":"In addition to referencing records directly by record ID, you may also reference by a matching attribute of your choice. For example, if you want to add a reference to the person record with email \"alice@website.com\", you should pass a value with `target_object` set to `\"people\"` and `email_addresses` set to `[{email_address:\"alice@website.com\"}]`. The key should be the slug or ID of the matching attribute you would like to use and the value should be an array containing a single value of the appropriate attribute type (as specified below). Matching on multiple values is not currently supported. Matching attributes must be unique. This process is similar to how you use the `matching_attribute` query param in Attio's [assert endpoints](/rest-api/endpoint-reference/records/assert-a-record).","items":{"anyOf":[{"type":"object","properties":{"domain":{"type":"string","example":"app.attio.com","description":"The full domain of the website."}}},{"type":"object","properties":{"email_address":{"type":"string","example":"alice@app.attio.com","description":"An email address string"}}},{"type":"object","properties":{"value":{"type":"number","example":17224912,"description":"Numbers are persisted as 64 bit floats."}}},{"type":"object","properties":{"original_phone_number":{"type":"string","example":"07234172834","description":"The raw, original phone number, as inputted."},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"GB","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to."}}},{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB."}}}]}}},"required":["target_object","[slug_or_id_of_matching_attribute]"]}],"example":{"target_object":"people","target_record_id":"891dcbfc-9141-415d-9b2a-2238a6cc012d"}}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}},"required":["value"],"additionalProperties":false}}},"description":"This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard workspace attribute. For information on potential custom attributes, refer to our [attribute type docs](/docs/attribute-types).","example":{"workspace_id":"123","name":"Customer.com","avatar_url":"https://example.com/avatar.png","users":[{"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1"}],"company":{"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab"}}}},"required":["values"],"additionalProperties":false}},"required":["data"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"users":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `workspace_id` or `name`) can be used, including custom attribute slugs.","example":{"workspace_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Fundstack","attribute_type":"text"}],"users":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1","attribute_type":"record-reference"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab","attribute_type":"record-reference"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://example.com/avatar.png","attribute_type":"text"}]}}},"required":["id","created_at","web_url","values"]}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["missing_value"]},"message":{"type":"string","example":"Required value for attribute with ID \"41252299-f8c7-4b5e-99c9-4ff8321d2f96\" was not provided."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Object with slug/ID \"people\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/workspaces/records/{record_id}/attributes/{attribute}/values":{"get":{"summary":"List workspace record attribute values","description":"Gets all values for a given attribute on a workspace record. Historic values can be queried using the `show_historic` query param. Historic values are sorted from oldest to newest (by `active_from`).\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Workspaces"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the workspace record to fetch attribute values for.","example":"72ef5feaf-4919-4208-b332-1339ab8ba040"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"string","description":"A UUID or slug to identify the attribute you want to query values on.","example":"workspace_id"},"required":true,"name":"attribute","in":"path"},{"schema":{"type":"boolean","description":"If `true`, the endpoint will return all historic values for the attribute. If `false`, the endpoint will only return the currently active value(s). Defaults to `false`. Cannot be set to `true` for COMINT attributes or enriched attributes on people/company objects.","example":true,"default":false},"required":false,"name":"show_historic","in":"query"},{"schema":{"type":"integer","description":"The maximum number of results to return. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"referenced_actor_type":{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of the referenced actor. [Read more information on actor types here](/docs/actors).","example":"workspace-member"},"referenced_actor_id":{"type":["string","null"],"format":"uuid","description":"The ID of the referenced actor.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"attribute_type":{"type":"string","enum":["actor-reference"],"description":"The attribute type of the value.","example":"actor-reference"}},"required":["active_from","active_until","created_by_actor","referenced_actor_type","referenced_actor_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"boolean","description":"A boolean representing whether the checkbox is checked or not. The string values 'true' and 'false' are also accepted.","example":true},"attribute_type":{"type":"string","enum":["checkbox"],"description":"The attribute type of the value.","example":"checkbox"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"currency_value":{"type":"number","description":"A numerical representation of the currency value. A decimal with a max of 4 decimal places.","example":99},"currency_code":{"type":["string","null"],"enum":["ARS","AUD","BRL","BGN","CAD","CLP","CNY","COP","CZK","DKK","EUR","FJD","HKD","HUF","ISK","INR","ILS","JPY","KES","KRW","MYR","MXN","NTD","NZD","NGN","NOK","XPF","PEN","PHP","PLN","GBP","RWF","SAR","SGD","ZAR","SEK","CHF","THB","AED","UYU","USD"],"description":"The ISO4217 currency code representing the currency that the value is stored in.","example":"USD"},"attribute_type":{"type":"string","enum":["currency"],"description":"The attribute type of the value.","example":"currency"}},"required":["active_from","active_until","created_by_actor","currency_value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["date"],"description":"The attribute type of the value.","example":"date"},"value":{"type":"string","description":"A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, \"2023\" and \"2023-01\" will be coerced into \"2023-01-01\", and \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T14:00:00\", \"2023-01-02T15:00:00.000000000\", and \"2023-01-02T15:00:00.000000000+02:00\" will all be coerced to \"2023-01-02\". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value \"2023-01-02T23:00:00-10:00\" will be returned as \"2023-01-03\". The maximum date is \"9999-12-31\".","example":"2023-01-01"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"domain":{"type":"string","example":"app.attio.com"},"root_domain":{"type":"string","example":"attio.com"},"attribute_type":{"type":"string","enum":["domain"],"description":"The attribute type of the value.","example":"domain"}},"required":["active_from","active_until","created_by_actor","domain","root_domain","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_email_address":{"type":"string","example":"alice@app.attio.com"},"email_address":{"type":"string","example":"alice@app.attio.com"},"email_domain":{"type":"string","example":"app.attio.com"},"email_root_domain":{"type":"string","example":"attio.com"},"email_local_specifier":{"type":"string","example":"alice"},"attribute_type":{"type":"string","enum":["email-address"],"description":"The attribute type of the value.","example":"email-address"}},"required":["active_from","active_until","created_by_actor","original_email_address","email_address","email_domain","email_root_domain","email_local_specifier","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"interaction_type":{"type":"string","enum":["calendar-event","call","chat-thread","email","in-person-meeting","meeting"],"description":"The type of interaction e.g. calendar or email.","example":"email"},"interacted_at":{"type":"string","format":"date-time","description":"When the interaction occurred.","example":"2023-01-01T15:00:00.000000000Z"},"owner_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["interaction"],"description":"The attribute type of the value.","example":"interaction"}},"required":["active_from","active_until","created_by_actor","interaction_type","interacted_at","owner_actor","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"line_1":{"type":["string","null"],"description":"The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"1 Infinite Loop"},"line_2":{"type":["string","null"],"description":"The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Block 1"},"line_3":{"type":["string","null"],"description":"The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Hilldrop Estate"},"line_4":{"type":["string","null"],"description":"The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.","example":"Westborough"},"locality":{"type":["string","null"],"description":"The town, neighborhood or area the location is in.","example":"Cupertino"},"region":{"type":["string","null"],"description":"The state, county, province or region that the location is in.","example":"CA"},"postcode":{"type":["string","null"],"description":"The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"95014"},"country_code":{"type":["string","null"],"enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"description":"The ISO 3166-1 alpha-2 country code for the country this location is in.","example":"US"},"latitude":{"type":["string","null"],"pattern":"^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$","description":"The latitude of the location. Validated by the regular expression `/^[-+]?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"37.331741"},"longitude":{"type":["string","null"],"pattern":"^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$","description":"The longitude of the location. Validated by the regular expression `/^[-+]?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$/`. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}","example":"-122.030333"},"attribute_type":{"type":"string","enum":["location"],"description":"The attribute type of the value.","example":"location"}},"required":["active_from","active_until","created_by_actor","line_1","line_2","line_3","line_4","locality","region","postcode","country_code","latitude","longitude","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"Numbers are persisted as 64 bit floats.","example":42},"attribute_type":{"type":"string","enum":["number"],"description":"The attribute type of the value.","example":"number"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"first_name":{"type":"string","description":"The first name.","example":"Ada"},"last_name":{"type":"string","description":"The last name.","example":"Lovelace"},"full_name":{"type":"string","description":"The full name.","example":"Ada Lovelace"},"attribute_type":{"type":"string","enum":["personal-name"],"description":"The attribute type of the value.","example":"personal-name"}},"required":["active_from","active_until","created_by_actor","first_name","last_name","full_name","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"original_phone_number":{"type":"string","description":"The raw, original phone number, as inputted.","example":"5558675309"},"country_code":{"type":"string","description":"The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","SS","RS","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","BQ","KP","SX","XK","AC"],"example":"US"},"phone_number":{"type":"string","example":"+15558675309"},"attribute_type":{"type":"string","enum":["phone-number"],"description":"The attribute type of the value.","example":"phone-number"}},"required":["active_from","active_until","created_by_actor","original_phone_number","country_code","phone_number","attribute_type"]},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"status":{"$ref":"#/components/schemas/status"},"attribute_type":{"type":"string","enum":["status"],"description":"The attribute type of the value.","example":"status"}},"required":["active_from","active_until","created_by_actor","status","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"number","description":"A number between 0 and 5 (inclusive) to represent a star rating.","example":3},"attribute_type":{"type":"string","enum":["rating"],"description":"The attribute type of the value.","example":"rating"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"option":{"$ref":"#/components/schemas/select-option"},"attribute_type":{"type":"string","enum":["select"],"description":"The attribute type of the value.","example":"select"}},"required":["active_from","active_until","created_by_actor","option","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false},{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"attribute_type":{"type":"string","enum":["timestamp"],"description":"The attribute type of the value.","example":"timestamp"},"value":{"type":"string","description":"A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, \"2023\", \"2023-01\", \"2023-01-02\", \"2023-01-02T13:00\", \"2023-01-02T13:00:00\", and \"2023-01-02T13:00:00.000000000\" will all be coerced to \"2023-01-02T13:00:00.000000000Z\". Timestamps are always returned in UTC. For example, writing a timestamp value using the string \"2023-01-02T13:00:00.000000000+02:00\" will result in the value \"2023-01-02T11:00:00.000000000Z\" being returned. The maximum date is \"9999-12-31T23:59:59.999999999Z\".","format":"date","example":"2023-01-01T15:00:00.000000000Z"}},"required":["active_from","active_until","created_by_actor","attribute_type","value"],"additionalProperties":false}]}}},"required":["data"],"description":"Success","example":{"data":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Fundstack","attribute_type":"text"}]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["validation_type"]},"message":{"type":"string","example":"Cannot set show_historic param to true when querying a COMINT attribute."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"Attribute with slug/ID \"my-attribute\" not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}},"/v2/objects/workspaces/records/{record_id}/entries":{"get":{"summary":"List workspace record entries","description":"List all entries, across all lists, for which this workspace record is the parent.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`, `list_entry:read`.","tags":["Workspaces"],"security":[{"oauth2":["record_permission:read","object_configuration:read","list_entry:read"]}],"parameters":[{"schema":{"type":"string","description":"A UUID of the workspace record to fetch entries for.","example":"72ef5feaf-4919-4208-b332-1339ab8ba040"},"required":true,"name":"record_id","in":"path"},{"schema":{"type":"integer","description":"The maximum number of results to return. The default is `100` and the maximum is `1000`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","description":"The number of results to skip over before returning. The default is `0`. See the [full guide to pagination here](/rest-api/guides/pagination).","example":5},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"list_id":{"type":"string","format":"uuid","description":"A UUID identifying the list that this record is in.","example":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"},"list_api_slug":{"type":"string","description":"A human-readable slug for the list for use in URLs and responses.","example":"hiring-engineering"},"entry_id":{"type":"string","format":"uuid","description":"A UUID identifying this entry on the list.","example":"2e6e29ea-c4e0-4f44-842d-78a891f8c156"},"created_at":{"type":"string","description":"When this entry was created.","example":"2022-11-21T13:22:49.061281000Z"}},"required":["list_id","list_api_slug","entry_id","created_at"]}}},"required":["data"],"description":"Success"}}}}}}},"/v2/objects/workspaces/records/query":{"post":{"summary":"List workspace records","description":"Lists workspace records, with the option to filter and sort results.\n\nRequired scopes: `record_permission:read`, `object_configuration:read`.","tags":["Workspaces"],"security":[{"oauth2":["record_permission:read","object_configuration:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"object","description":"An object used to filter results to a subset of records. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","additionalProperties":true,"example":{"$and":[{"workspace_id":{"value":{"$eq":"123"}}}]}},"sorts":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"attribute":{"type":"string","description":"A slug or ID to identify the attribute to sort by."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","attribute"],"description":"Sort by attribute"},{"type":"object","properties":{"direction":{"type":"string","enum":["asc","desc"],"description":"The direction to sort the results by."},"path":{"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","description":"The slug or ID of the object e.g. \"people\"."},{"type":"string","description":"A slug or ID to identify the attribute to sort by."}]},"minItems":2,"maxItems":2},"description":"You may use the `path` property to traverse record reference attributes and parent records on list entries. `path` accepts an array of tuples where the first element of each tuple is the slug or ID of a list/object, and the second element is the slug or ID of an attribute on that list/object. The first element of the first tuple must correspond to the list or object that you are querying. For example, if you wanted to sort by the name of the parent record (a company) on a list with the slug \"sales\", you would pass the value `[['sales', 'parent_record'], ['companies', 'name']]`."},"field":{"type":"string","description":"Which field on the value to sort by e.g. \"last_name\" on a name value."}},"required":["direction","path"],"description":"Sort by path"}]},"description":"An object used to sort results. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).","example":[{"direction":"asc","attribute":"name","field":"last_name"}]},"limit":{"type":"number","description":"The maximum number of results to return. Defaults to 500. See the [full guide to pagination here](/rest-api/guides/pagination).","example":500},"offset":{"type":"number","description":"The number of results to skip over before returning. Defaults to 0. See the [full guide to pagination here](/rest-api/guides/pagination).","example":0}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid","description":"A UUID identifying the workspace this record belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c"},"object_id":{"type":"string","format":"uuid","description":"A UUID identifying the object this record belongs to.","example":"97052eb9-e65e-443f-a297-f2d9a4a7f795"},"record_id":{"type":"string","format":"uuid","description":"A UUID identifying this record.","example":"bf071e1f-6035-429d-b874-d83ea64ea13b"}},"required":["workspace_id","object_id","record_id"]},"created_at":{"type":"string","description":"When this record was created.","example":"2022-11-21T13:22:49.061281000Z"},"web_url":{"type":"string","format":"uri","description":"A URL that links directly to the record page in the Attio web application.","example":"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"},"values":{"type":"object","properties":{"workspace_id":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"name":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}},"users":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"company":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"target_object":{"type":"string","description":"A slug identifying the object that the referenced record belongs to.","example":"people"},"target_record_id":{"type":"string","format":"uuid","description":"A UUID to identify the referenced record.","example":"891dcbfc-9141-415d-9b2a-2238a6cc012d"},"attribute_type":{"type":"string","enum":["record-reference"],"description":"The attribute type of the value.","example":"record-reference"}},"required":["active_from","active_until","created_by_actor","target_object","target_record_id","attribute_type"],"additionalProperties":false}},"avatar_url":{"type":"array","items":{"type":"object","properties":{"active_from":{"type":"string","format":"date-time","description":"The point in time at which this value was made \"active\". `active_from` can be considered roughly analogous to `created_at`.","example":"2023-01-01T15:00:00.000000000Z"},"active_until":{"type":["string","null"],"format":"date-time","description":"The point in time at which this value was deactivated. If `null`, the value is active.","example":"2023-01-01T15:00:00.000000000Z"},"created_by_actor":{"type":"object","description":"The actor that created this value.","properties":{"id":{"type":"string","description":"An ID to identify the actor.","nullable":true},"type":{"type":"string","enum":["api-token","workspace-member","system","app"],"nullable":true,"description":"The type of actor. [Read more information on actor types here](/docs/actors)."}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}},"value":{"type":"string","description":"A raw text field. Values are limited to 10MB.","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."},"attribute_type":{"type":"string","enum":["text"],"description":"The attribute type of the value.","example":"text"}},"required":["active_from","active_until","created_by_actor","value","attribute_type"],"additionalProperties":false}}},"description":"An object with `attribute_slug` keys, and an array of value objects as the values. Attributes slugs (for example `workspace_id` or `name`) can be used, including custom attribute slugs.","example":{"workspace_id":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"123","attribute_type":"text"}],"name":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"Fundstack","attribute_type":"text"}],"users":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"users","target_record_id":"5e3fb280-007b-495a-a530-9354bde01de1","attribute_type":"record-reference"}],"company":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"target_object":"companies","target_record_id":"99a03ff3-0435-47da-95cc-76b2caeb4dab","attribute_type":"record-reference"}],"avatar_url":[{"active_from":"2023-01-01T15:00:00.000000000Z","active_until":null,"created_by_actor":{"type":"system","id":null},"value":"https://example.com/avatar.png","attribute_type":"text"}]}}},"required":["id","created_at","web_url","values"]}}},"required":["data"],"description":"Success"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["filter_error"]},"message":{"type":"string","example":"Error in filter."}},"required":["status_code","type","code","message"],"description":"Bad Request"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404]},"type":{"type":"string","enum":["invalid_request_error"]},"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","example":"The referenced object was not found."}},"required":["status_code","type","code","message"],"description":"Not Found"}}}}}}}},"webhooks":{}}