{
"status_code": 400,
"type": "invalid_request_error",
"code": "value_not_found",
"message": "Workspace member with ID \"50cf242c-7fa3-4cad-87d0-75b1af71c57b\" not found."
}
{
"status_code": 404,
"type": "invalid_request_error",
"code": "not_found",
"message": "List with slug/ID \"enterprise_sales\" not found."
}
Lists
Update a list
Updates an existing list. Permissions for the list are controlled with the workspace_access and workspace_member_access parameters. Please note that lists must have either workspace_access set to "full-access" or one or more element of workspace_member_access with a "full-access" level. It is also possible to receive a 403 billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI.
{
"status_code": 400,
"type": "invalid_request_error",
"code": "value_not_found",
"message": "Workspace member with ID \"50cf242c-7fa3-4cad-87d0-75b1af71c57b\" not found."
}
{
"status_code": 404,
"type": "invalid_request_error",
"code": "not_found",
"message": "List with slug/ID \"enterprise_sales\" not found."
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Attio Docs","colors":{"primary":"#3b6be8","light":"#f1f3f5"},"logo":{"light":"https://mintcdn.com/attio/uDPxmqB0ooRQJQ39/logo/light.svg?fit=max\u0026auto=format\u0026n=uDPxmqB0ooRQJQ39\u0026q=85\u0026s=9af1b9c979be94d84881d4779d7eb31f","dark":"https://mintcdn.com/attio/uDPxmqB0ooRQJQ39/logo/dark.svg?fit=max\u0026auto=format\u0026n=uDPxmqB0ooRQJQ39\u0026q=85\u0026s=52a2e543a1cd72afbc860cc48259bd57"},"favicon":"https://mintcdn.com/attio/DVPA9KuK1yKhf6bD/favicon.svg?fit=max\u0026auto=format\u0026n=DVPA9KuK1yKhf6bD\u0026q=85\u0026s=b9d65163aef9a3430f212095aff95ec4","background":{"color":{"light":"#fff","dark":"#191b1f"}},"footer":{"socials":{"x":"https://x.com/Attio","website":"https://attio.com"}},"seo":{"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":100},"body":{"family":"Inter"}},"styling":{"codeblocks":"system","latex":true},"integrations":{"ga4":{"measurementId":"G-PZRKGLEPJ3"},"intercom":{"appId":"cqp3eh0z"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Developer console","icon":"terminal","href":"https://build.attio.com/"},{"anchor":"Support","icon":"headset","href":"https://attio.com/help"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"attio","hasAudioNarration":false,"actualSubdomain":"attio","customDomains":["docs.attio.com"],"gitSource":{"type":"github","owner":"attio","repo":"developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae46ed3624e9267b4d5a822","collectionId":"6959b935-d72e-4d9b-9be8-f7defd42a6c7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae46ed3624e9267b4d5a822"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae50e8db08e4182b98c4b14","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"REST API","count":215},{"language":"default","tag":"Endpoint reference","count":154},{"language":"default","tag":"App SDK","count":147},{"language":"default","tag":"Core endpoints","count":96},{"language":"default","tag":"Components","count":62},{"language":"default","tag":"Standard objects","count":46},{"language":"default","tag":"Webhook reference","count":34},{"language":"default","tag":"Guides","count":21},{"language":"default","tag":"Attribute types","count":18},{"language":"default","tag":"Forms","count":18}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"*{--font-weight-headings-custom:500}th{text-align:left}:not(pre)>code{padding:.125rem}.mermaid-inline button{width:100%;display:flex;justify-content:center;align-items:center}.mermaid-inline button>a{width:100%}img[alt~=logo]{width:90px}.rounded-2xl,.rounded-xl{border-radius:10px}.rounded-\\[14px\\][data-component-part=code-block-root]{border-radius:8px}#navbar div>a[href=\"/sdk/guides/creating-an-app\"]::after{content:\"Alpha\";display:inline-block;font-size:.7rem;font-weight:600;color:#f97514;background-color:rgb(249,117,20,.1);padding:.1rem .4rem;border-radius:4px;margin-left:.5rem}#navbar div>a[href=\"/sdk/guides/creating-an-app\"],#navigation-items>ul>li>a[href=\"/sdk/guides/creating-an-app\"]{position:relative}#navigation-items>ul>li>a[href=\"/sdk/guides/creating-an-app\"]::after{content:\"Alpha\";display:inline-block;font-size:.7rem;font-weight:600;color:#06f;background-color:rgba(0,102,255,.1);padding:.1rem .4rem;border-radius:4px;margin-left:.5rem}"}],"page":{"pagePath":"rest-api/endpoint-reference/lists/update-a-list","slug":"/rest-api/endpoint-reference/lists/update-a-list","pageMetadata":{"title":"Update a list","description":"Updates an existing list. Permissions for the list are controlled with the `workspace_access` and `workspace_member_access` parameters. Please note that lists must have either `workspace_access` set to `\"full-access\"` or one or more element of `workspace_member_access` with a `\"full-access\"` level. It is also possible to receive a `403` billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI.\n\nRequired scopes: `list_configuration:read-write`.\n\nSupported token levels: `workspace`, `user`.","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/lists/{list}","href":"/rest-api/endpoint-reference/lists/update-a-list","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Updates an existing list. Permissions for the list are controlled with the \", _jsx(_components.code, {\n children: \"workspace_access\"\n }), \" and \", _jsx(_components.code, {\n children: \"workspace_member_access\"\n }), \" parameters. Please note that lists must have either \", _jsx(_components.code, {\n children: \"workspace_access\"\n }), \" set to \", _jsx(_components.code, {\n children: \"\\\"full-access\\\"\"\n }), \" or one or more element of \", _jsx(_components.code, {\n children: \"workspace_member_access\"\n }), \" with a \", _jsx(_components.code, {\n children: \"\\\"full-access\\\"\"\n }), \" level. It is also possible to receive a \", _jsx(_components.code, {\n children: \"403\"\n }), \" billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Required scopes: \", _jsx(_components.code, {\n children: \"list_configuration:read-write\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Supported token levels: \", _jsx(_components.code, {\n children: \"workspace\"\n }), \", \", _jsx(_components.code, {\n children: \"user\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Update a list","description":"Updates an existing list. Permissions for the list are controlled with the `workspace_access` and `workspace_member_access` parameters. Please note that lists must have either `workspace_access` set to `\"full-access\"` or one or more element of `workspace_member_access` with a `\"full-access\"` level. It is also possible to receive a `403` billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI.\n\nRequired scopes: `list_configuration:read-write`.\n\nSupported token levels: `workspace`, `user`.","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/lists/{list}","href":"/rest-api/endpoint-reference/lists/update-a-list","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update a list","description":"Updates an existing list. Permissions for the list are controlled with the `workspace_access` and `workspace_member_access` parameters. Please note that lists must have either `workspace_access` set to `\"full-access\"` or one or more element of `workspace_member_access` with a `\"full-access\"` level. It is also possible to receive a `403` billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI.\n\nRequired scopes: `list_configuration:read-write`.\n\nSupported token levels: `workspace`, `user`.","tags":["Lists"],"security":["617970e6-5f3b-452e-84b3-66ddad51a106"],"parameters":["d27cd7b7-db17-43c8-91d3-1f24496d0112"],"requestBody":"0b4688cf-f0cc-428f-9935-723ccc444a27","responses":{"200":"5746270e-eb84-4b2d-aa92-be805dcc6ffd","400":"b01fd4f6-54ea-4154-9502-d4038ca580c9","404":"0ed4e11b-5b04-45cc-8495-73d2ddb85258"},"method":"patch","type":"path","servers":["550bedb6-7c0c-45ab-82d1-81b47b937ab0"],"path":"/v2/lists/{list}","baseUrlOptions":["https://api.attio.com"],"title":"Update a list","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d27cd7b7-db17-43c8-91d3-1f24496d0112":{"schema":{"type":"string","description":"A UUID or slug to identify the list to update.","example":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"list","in":"path"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"name":{"type":"string","description":"The human-readable name of the list.","example":"Enterprise Sales","uniqueKey":"data.name","typeLabel":"string"},"api_slug":{"type":"string","description":"A unique, human-readable slug to access the list through API calls. Should be formatted in snake case.","example":"enterprise_sales","uniqueKey":"data.api_slug","typeLabel":"string"},"workspace_access":{"oneOf":[{"type":"string","enum":["full-access","read-and-write","read-only"],"description":"The level of access granted to all members of the workspace for this list. Pass `null` to keep the list private and only grant access to specific workspace members.","example":"read-and-write","uniqueKey":"data.workspace_access.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["full-access","read-and-write","read-only"],"description":"The level of access granted to all members of the workspace for this list. Pass `null` to keep the list private and only grant access to specific workspace members.","example":"read-and-write","uniqueKey":"data.workspace_access.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.workspace_access","typeLabel":"enum\u003cstring> | null"},"workspace_member_access":{"type":"array","items":{"type":"object","properties":{"workspace_member_id":{"type":"string","format":"uuid","description":"A UUID to identify the workspace member to grant access to.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","isRequired":true,"uniqueKey":"data.workspace_member_access.items.[INDEX].workspace_member_id","typeLabel":"string\u003cuuid>"},"level":{"type":"string","enum":["full-access","read-and-write","read-only"],"description":"The level of access to the list.","example":"read-and-write","isRequired":true,"uniqueKey":"data.workspace_member_access.items.[INDEX].level","typeLabel":"enum\u003cstring>"}},"required":["workspace_member_id","level"],"uniqueKey":"data.workspace_member_access.items.[INDEX]","typeLabel":"object"},"description":"The level of access granted to specific workspace members for this list. Pass an empty array to grant access to no workspace members.","uniqueKey":"data.workspace_member_access","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"name":"Enterprise Sales","api_slug":"enterprise_sales","workspace_access":"read-and-write","workspace_member_access":[{"workspace_member_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","level":"read-and-write"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5746270e-eb84-4b2d-aa92-be805dcc6ffd":{"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 to identify the workspace this list belongs to.","example":"14beef7a-99f7-4534-a87e-70b564330a4c","isRequired":true,"uniqueKey":"data.id.workspace_id","typeLabel":"string\u003cuuid>"},"list_id":{"type":"string","format":"uuid","description":"A UUID to identify this list.","example":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0","isRequired":true,"uniqueKey":"data.id.list_id","typeLabel":"string\u003cuuid>"}},"required":["workspace_id","list_id"],"isRequired":true,"uniqueKey":"data.id","typeLabel":"object"},"api_slug":{"type":"string","description":"A human-readable slug for use in URLs and responses.","example":"enterprise_sales","isRequired":true,"uniqueKey":"data.api_slug","typeLabel":"string"},"name":{"type":"string","description":"The name of the list, as viewed in the UI.","example":"Hiring Engineering","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"parent_object":{"type":"array","items":{"type":"string","uniqueKey":"data.parent_object.items.[INDEX]","typeLabel":"string"},"description":"A UUID or slug to identify the allowed object type for records added to this list. All new Lists are expected to have exactly one parent object. However, some legacy lists may have multiple allowed parents so the return type of this field is an array.","example":["people"],"isRequired":true,"uniqueKey":"data.parent_object","typeLabel":"string[]"},"workspace_access":{"oneOf":[{"type":"string","enum":["full-access","read-and-write","read-only"],"description":"The level of access granted to all members of the workspace for this list. `null` values represent a private list that only grants access to specific workspace members via the `workspace_member_access` property.","example":"read-and-write","isRequired":true,"uniqueKey":"data.workspace_access.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["full-access","read-and-write","read-only"],"description":"The level of access granted to all members of the workspace for this list. `null` values represent a private list that only grants access to specific workspace members via the `workspace_member_access` property.","example":"read-and-write","isRequired":true,"uniqueKey":"data.workspace_access.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.workspace_access","typeLabel":"enum\u003cstring> | null"},"workspace_member_access":{"type":"array","items":{"type":"object","properties":{"workspace_member_id":{"type":"string","format":"uuid","description":"A UUID to identify the workspace member to grant access to.","example":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","isRequired":true,"uniqueKey":"data.workspace_member_access.items.[INDEX].workspace_member_id","typeLabel":"string\u003cuuid>"},"level":{"type":"string","enum":["full-access","read-and-write","read-only"],"description":"The level of access to the list.","example":"read-and-write","isRequired":true,"uniqueKey":"data.workspace_member_access.items.[INDEX].level","typeLabel":"enum\u003cstring>"}},"required":["workspace_member_id","level"],"uniqueKey":"data.workspace_member_access.items.[INDEX]","typeLabel":"object"},"description":"The level of access granted to specific workspace members for this list. An empty array represents a list that has granted access to no workspace members.","isRequired":true,"uniqueKey":"data.workspace_member_access","typeLabel":"object[]"},"created_by_actor":{"type":"object","description":"The actor which created this list.","properties":{"id":{"oneOf":[{"type":"string","description":"An ID to identify the actor.","uniqueKey":"data.created_by_actor.id.oneOf.0","typeLabel":"string"},{"type":"null","description":"An ID to identify the actor.","uniqueKey":"data.created_by_actor.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.created_by_actor.id","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","enum":["api-token","workspace-member","system","app"],"description":"The type of actor. [Read more information on actor types here](/docs/actors).","uniqueKey":"data.created_by_actor.type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["api-token","workspace-member","system","app"],"description":"The type of actor. [Read more information on actor types here](/docs/actors).","uniqueKey":"data.created_by_actor.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.created_by_actor.type","typeLabel":"enum\u003cstring> | null"}},"example":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"isRequired":true,"uniqueKey":"data.created_by_actor","typeLabel":"object"},"created_at":{"type":"string","description":"When the list was created.","example":"2022-11-21T13:22:49.061281000Z","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string"}},"required":["id","api_slug","name","parent_object","workspace_access","workspace_member_access","created_by_actor","created_at"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"description":"Success","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":{"workspace_id":"14beef7a-99f7-4534-a87e-70b564330a4c","list_id":"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"},"api_slug":"enterprise_sales","name":"Hiring Engineering","parent_object":["people"],"workspace_access":"read-and-write","workspace_member_access":[{"workspace_member_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b","level":"read-and-write"}],"created_by_actor":{"type":"workspace-member","id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"},"created_at":"2022-11-21T13:22:49.061281000Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b01fd4f6-54ea-4154-9502-d4038ca580c9":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[400],"isRequired":true,"uniqueKey":"status_code","typeLabel":"enum\u003cnumber>"},"type":{"type":"string","enum":["invalid_request_error"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["value_not_found"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Workspace member with ID \"50cf242c-7fa3-4cad-87d0-75b1af71c57b\" not found.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status_code","type","code","message"],"description":"Bad Request","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status_code":400,"type":"invalid_request_error","code":"value_not_found","message":"Workspace member with ID \"50cf242c-7fa3-4cad-87d0-75b1af71c57b\" not found."}}},"exampleType":"generated"}},"exampleType":"generated"},"0ed4e11b-5b04-45cc-8495-73d2ddb85258":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"status_code":{"type":"number","enum":[404],"isRequired":true,"uniqueKey":"status_code","typeLabel":"enum\u003cnumber>"},"type":{"type":"string","enum":["invalid_request_error"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["not_found"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"List with slug/ID \"enterprise_sales\" not found.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status_code","type","code","message"],"description":"Not Found","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status_code":404,"type":"invalid_request_error","code":"not_found","message":"List with slug/ID \"enterprise_sales\" not found."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"617970e6-5f3b-452e-84b3-66ddad51a106":{"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.","email:read":"View email metadata. Email content is never exposed.","email:read-write":"View email metadata. Email content is never exposed.","activity_configuration:read":"View, and optionally write, the configuration and attributes of activities.","activity_configuration:read-write":"View, and optionally write, the configuration and attributes of activities.","activity_record:read":"View, and optionally write, activity records.","activity_record:read-write":"View, and optionally write, activity records.","sequence_unsubscribe:read":"View, and optionally add to, the sequence unsubscribe list.","sequence_unsubscribe:read-write":"View, and optionally add to, the sequence unsubscribe list."}}},"scopes":["list_configuration:read-write"],"schemeName":"oauth2"}}},"servers":{"550bedb6-7c0c-45ab-82d1-81b47b937ab0":{"url":"https://api.attio.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"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.","email:read":"View email metadata. Email content is never exposed.","email:read-write":"View email metadata. Email content is never exposed.","activity_configuration:read":"View, and optionally write, the configuration and attributes of activities.","activity_configuration:read-write":"View, and optionally write, the configuration and attributes of activities.","activity_record:read":"View, and optionally write, activity records.","activity_record:read-write":"View, and optionally write, activity records.","sequence_unsubscribe:read":"View, and optionally add to, the sequence unsubscribe list.","sequence_unsubscribe:read-write":"View, and optionally add to, the sequence unsubscribe list."}}},"scopes":["list_configuration:read-write"],"schemeName":"oauth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"This API uses OAuth 2.0 with the authorization code grant flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"}],"title":"oauth2"}]},"originalFileLocation":"https://api.attio.com/openapi/api"},"subdomain":"attio","siteName":"Attio Docs","title":"Update a list - Attio Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T10:18:12.666Z","originalFileLocation":"rest-api/endpoint-reference/lists/update-a-list.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Updates an existing list. Permissions for the list are controlled with the workspace_access and workspace_member_access parameters. Please note that lists must have either workspace_access set to \u0026quot;full-access\u0026quot; or one or more element of workspace_member_access with a \u0026quot;full-access\u0026quot; level. It is also possible to receive a 403 billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI. Required scopes: list_configuration:read-write. Supported token levels: workspace, user.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Attio Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update a list - Attio Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Updates an existing list. Permissions for the list are controlled with the workspace_access and workspace_member_access parameters. Please note that lists must have either workspace_access set to \u0026quot;full-access\u0026quot; or one or more element of workspace_member_access with a \u0026quot;full-access\u0026quot; level. It is also possible to receive a 403 billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI. Required scopes: list_configuration:read-write. Supported token levels: workspace, user.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Attio Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://attio.mintlify.app/_mintlify/api/og/v2?division=Lists\u0026amp;title=Update+a+list\u0026amp;description=Updates+an+existing+list.+Permissions+for+the+list+are+controlled+with+the+%60workspace_access%60+and+%60workspace_member_access%60+parameters.+Please+note+that+lists+m\u0026amp;theme=d607837df3ef191e4b13ec8c\u0026amp;signature=60719a68140655696dcdf8a050fbb936c81c7b894849a84218706215a7da0f21\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update a list - Attio Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Updates an existing list. Permissions for the list are controlled with the workspace_access and workspace_member_access parameters. Please note that lists must have either workspace_access set to \u0026quot;full-access\u0026quot; or one or more element of workspace_member_access with a \u0026quot;full-access\u0026quot; level. It is also possible to receive a 403 billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI. Required scopes: list_configuration:read-write. Supported token levels: workspace, user.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://attio.mintlify.app/_mintlify/api/og/v2?division=Lists\u0026amp;title=Update+a+list\u0026amp;description=Updates+an+existing+list.+Permissions+for+the+list+are+controlled+with+the+%60workspace_access%60+and+%60workspace_member_access%60+parameters.+Please+note+that+lists+m\u0026amp;theme=d607837df3ef191e4b13ec8c\u0026amp;signature=60719a68140655696dcdf8a050fbb936c81c7b894849a84218706215a7da0f21\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/attio/tuL1-j3wTEWKOtgw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Attio Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3b6be8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/rest-api/endpoint-reference/lists/update-a-list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.attio.com/#organization\",\"name\":\"Attio Docs\",\"url\":\"https://docs.attio.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/attio/uDPxmqB0ooRQJQ39/logo/light.svg?fit=max\u0026auto=format\u0026n=uDPxmqB0ooRQJQ39\u0026q=85\u0026s=9af1b9c979be94d84881d4779d7eb31f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.attio.com#website\",\"name\":\"Attio Docs\",\"url\":\"https://docs.attio.com\",\"publisher\":{\"@id\":\"https://docs.attio.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list#webpage\",\"url\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list\",\"name\":\"Update a list\",\"description\":\"Updates an existing list. Permissions for the list are controlled with the workspace_access and workspace_member_access parameters. Please note that lists must have either workspace_access set to \\\"full-access\\\" or one or more element of workspace_member_access with a \\\"full-access\\\" level. It is also possible to receive a 403 billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI. Required scopes: list_configuration:read-write. Supported token levels: workspace, user.\",\"dateModified\":\"2026-10-30T10:18:12.666Z\",\"isPartOf\":{\"@id\":\"https://docs.attio.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoint reference\",\"item\":\"https://docs.attio.com/rest-api/endpoint-reference/openapi\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Core endpoints\",\"item\":\"https://docs.attio.com/rest-api/endpoint-reference/objects/list-objects\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Lists\",\"item\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/list-all-lists\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Update a list\",\"item\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list#apireference\",\"headline\":\"Update a list\",\"name\":\"Update a list\",\"description\":\"Updates an existing list. Permissions for the list are controlled with the workspace_access and workspace_member_access parameters. Please note that lists must have either workspace_access set to \\\"full-access\\\" or one or more element of workspace_member_access with a \\\"full-access\\\" level. It is also possible to receive a 403 billing error if your workspace is not on a plan that supports either advanced workspace or workspace member level access for lists. Changing the parent object of a list is not possible through the API as it can have unintended side-effects that should be considered carefully. If you wish to carry out a parent object change you should do so through the UI. Required scopes: list_configuration:read-write. Supported token levels: workspace, user.\",\"url\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.attio.com/rest-api/endpoint-reference/lists/update-a-list#webpage\"},\"dateModified\":\"2026-10-30T10:18:12.666Z\",\"publisher\":{\"@id\":\"https://docs.attio.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.attio.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Attio Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Attio Docs","nav":{"global":{"anchors":[{"anchor":"Developer console","icon":"terminal","href":"https://build.attio.com/"},{"anchor":"Support","icon":"headset","href":"https://attio.com/help"}]},"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/docs/overview"}]},{"tab":"App SDK","pages":[{"title":"App SDK","href":"/sdk/overview"}]},{"tab":"REST API","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/rest-api/overview"}]},{"group":"Guides","pages":[{"title":"Authenticating requests","href":"/rest-api/guides/authentication"},{"title":"Handling rate limits","href":"/rest-api/guides/rate-limiting"},{"title":"Filtering and sorting","href":"/rest-api/guides/filtering-and-sorting"},{"title":"Linking referenced records","href":"/rest-api/guides/linking-referenced-records"},{"title":"Paginating API results","href":"/rest-api/guides/pagination"},{"title":"Configuring webhooks","href":"/rest-api/guides/webhooks"},{"title":"Working with activities","href":"/rest-api/guides/activities"}]},{"group":"Tutorials","pages":[{"title":"Connect an app to Attio through OAuth","href":"/rest-api/tutorials/connect-an-app-through-oauth"}]},{"group":"Attribute types","pages":[{"title":"Overview","href":"/rest-api/attribute-types/attribute-types"},{"title":"Actor reference","href":"/rest-api/attribute-types/attribute-types-actor-reference"},{"title":"Checkbox","href":"/rest-api/attribute-types/attribute-types-checkbox"},{"title":"Currency","href":"/rest-api/attribute-types/attribute-types-currency"},{"title":"Date","href":"/rest-api/attribute-types/attribute-types-date"},{"title":"Domain","href":"/rest-api/attribute-types/attribute-types-domain"},{"title":"Email address","href":"/rest-api/attribute-types/attribute-types-email-address"},{"title":"Interaction","href":"/rest-api/attribute-types/attribute-types-interaction"},{"title":"Location","href":"/rest-api/attribute-types/attribute-types-location"},{"title":"(Personal) name","href":"/rest-api/attribute-types/attribute-types-personal-name"},{"title":"Number","href":"/rest-api/attribute-types/attribute-types-number"},{"title":"Phone number","href":"/rest-api/attribute-types/attribute-types-phone-number"},{"title":"Rating","href":"/rest-api/attribute-types/attribute-types-rating"},{"title":"Record reference","href":"/rest-api/attribute-types/attribute-types-record-reference"},{"title":"Select","href":"/rest-api/attribute-types/attribute-types-select"},{"title":"Status","href":"/rest-api/attribute-types/attribute-types-status"},{"title":"Text","href":"/rest-api/attribute-types/attribute-types-text"},{"title":"Timestamp","href":"/rest-api/attribute-types/attribute-types-timestamp"}]},{"group":"Endpoint reference","pages":[{"title":"OpenAPI","href":"/rest-api/endpoint-reference/openapi"},{"group":"Core endpoints","pages":[{"group":"Objects","pages":[{"title":"List objects","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/objects","href":"/rest-api/endpoint-reference/objects/list-objects"},{"title":"Create an object","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/objects","href":"/rest-api/endpoint-reference/objects/create-an-object"},{"title":"Get an object","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/objects/{object}","href":"/rest-api/endpoint-reference/objects/get-an-object"},{"title":"Delete an object","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api delete /v2/objects/{object}","href":"/rest-api/endpoint-reference/objects/delete-an-object"},{"title":"Update an object","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/objects/{object}","href":"/rest-api/endpoint-reference/objects/update-an-object"},{"title":"List views for object","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/objects/{object}/views","href":"/rest-api/endpoint-reference/objects/list-views-for-object"}]},{"group":"Activities","pages":[{"title":"List activities","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/activities","href":"/rest-api/endpoint-reference/activities/list-activities"},{"title":"Create an activity","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/activities","href":"/rest-api/endpoint-reference/activities/create-an-activity"},{"title":"Get an activity","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/activities/{activity}","href":"/rest-api/endpoint-reference/activities/get-an-activity"},{"title":"Delete an activity","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api delete /v2/activities/{activity}","href":"/rest-api/endpoint-reference/activities/delete-an-activity"},{"title":"Update an activity","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api patch /v2/activities/{activity}","href":"/rest-api/endpoint-reference/activities/update-an-activity"}]},{"group":"Attributes","pages":[{"title":"List attributes","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/{target}/{identifier}/attributes","href":"/rest-api/endpoint-reference/attributes/list-attributes"},{"title":"Create an attribute","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/{target}/{identifier}/attributes","href":"/rest-api/endpoint-reference/attributes/create-an-attribute"},{"title":"Get an attribute","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/{target}/{identifier}/attributes/{attribute}","href":"/rest-api/endpoint-reference/attributes/get-an-attribute"},{"title":"Update an attribute","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/{target}/{identifier}/attributes/{attribute}","href":"/rest-api/endpoint-reference/attributes/update-an-attribute"},{"title":"List select options","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/{target}/{identifier}/attributes/{attribute}/options","href":"/rest-api/endpoint-reference/attributes/list-select-options"},{"title":"Create a select option","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/{target}/{identifier}/attributes/{attribute}/options","href":"/rest-api/endpoint-reference/attributes/create-a-select-option"},{"title":"Update a select option","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/{target}/{identifier}/attributes/{attribute}/options/{option}","href":"/rest-api/endpoint-reference/attributes/update-a-select-option"},{"title":"List statuses","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/{target}/{identifier}/attributes/{attribute}/statuses","href":"/rest-api/endpoint-reference/attributes/list-statuses"},{"title":"Create a status","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/{target}/{identifier}/attributes/{attribute}/statuses","href":"/rest-api/endpoint-reference/attributes/create-a-status"},{"title":"Update a status","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/{target}/{identifier}/attributes/{attribute}/statuses/{status}","href":"/rest-api/endpoint-reference/attributes/update-a-status"}]},{"group":"Records","pages":[{"title":"List records","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/objects/{object}/records/query","href":"/rest-api/endpoint-reference/records/list-records"},{"title":"Upsert a record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api put /v2/objects/{object}/records","href":"/rest-api/endpoint-reference/records/upsert-a-record"},{"title":"Create a record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/objects/{object}/records","href":"/rest-api/endpoint-reference/records/create-a-record"},{"title":"Get a record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/objects/{object}/records/{record_id}","href":"/rest-api/endpoint-reference/records/get-a-record"},{"title":"Update a record (overwrite multiselect values)","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api put /v2/objects/{object}/records/{record_id}","href":"/rest-api/endpoint-reference/records/update-a-record-overwrite-multiselect-values"},{"title":"Delete a record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api delete /v2/objects/{object}/records/{record_id}","href":"/rest-api/endpoint-reference/records/delete-a-record"},{"title":"Update a record (append multiselect values)","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/objects/{object}/records/{record_id}","href":"/rest-api/endpoint-reference/records/update-a-record-append-multiselect-values"},{"title":"Merge two records","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/objects/{object}/records/merge","href":"/rest-api/endpoint-reference/records/merge-two-records"},{"title":"List record attribute values","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/objects/{object}/records/{record_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/records/list-record-attribute-values"},{"title":"Write record attribute values","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api put /v2/objects/{object}/records/{record_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/records/write-record-attribute-values"},{"title":"List record entries","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/objects/{object}/records/{record_id}/entries","href":"/rest-api/endpoint-reference/records/list-record-entries"},{"title":"Search records","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/objects/records/search","href":"/rest-api/endpoint-reference/records/search-records"}]},{"group":"Activity records","pages":[{"title":"List activity records","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/activities/{activity}/records/query","href":"/rest-api/endpoint-reference/activity-records/list-activity-records"},{"title":"Upsert an activity record","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api put /v2/activities/{activity}/records","href":"/rest-api/endpoint-reference/activity-records/upsert-an-activity-record"},{"title":"Create an activity record","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/activities/{activity}/records","href":"/rest-api/endpoint-reference/activity-records/create-an-activity-record"},{"title":"Get an activity record","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/activities/{activity}/records/{record_id}","href":"/rest-api/endpoint-reference/activity-records/get-an-activity-record"},{"title":"Update an activity record (overwrite multiselect values)","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api put /v2/activities/{activity}/records/{record_id}","href":"/rest-api/endpoint-reference/activity-records/update-an-activity-record-overwrite-multiselect-values"},{"title":"Delete an activity record","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api delete /v2/activities/{activity}/records/{record_id}","href":"/rest-api/endpoint-reference/activity-records/delete-an-activity-record"},{"title":"Update an activity record (append multiselect values)","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api patch /v2/activities/{activity}/records/{record_id}","href":"/rest-api/endpoint-reference/activity-records/update-an-activity-record-append-multiselect-values"}]},{"group":"SQL","pages":[{"title":"Query SQL","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/sql","href":"/rest-api/endpoint-reference/sql/query-sql"}]},{"group":"Lists","pages":[{"title":"List all lists","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/lists","href":"/rest-api/endpoint-reference/lists/list-all-lists"},{"title":"Create a list","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/lists","href":"/rest-api/endpoint-reference/lists/create-a-list"},{"title":"Get a list","description":"Gets a single list in your workspace that your access token has access to.\n\nRequired scopes: `list_configuration:read`.\n\nSupported token levels: `workspace`, `user`.","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/lists/{list}","href":"/rest-api/endpoint-reference/lists/get-a-list"},{"title":"Update a list","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/lists/{list}","href":"/rest-api/endpoint-reference/lists/update-a-list"},{"title":"List views for list","description":"Lists saved views for a list. Results are ordered by view ID (`id.view_id` ascending).\n\nRequired scopes: `list_configuration:read`.\n\nSupported token levels: `workspace`, `user`.","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/lists/{list}/views","href":"/rest-api/endpoint-reference/lists/list-views-for-list"}]},{"group":"Entries","pages":[{"title":"List entries","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/lists/{list}/entries/query","href":"/rest-api/endpoint-reference/entries/list-entries"},{"title":"Upsert a list entry by parent","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api put /v2/lists/{list}/entries","href":"/rest-api/endpoint-reference/entries/upsert-a-list-entry-by-parent"},{"title":"Create an entry (add record to list)","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/lists/{list}/entries","href":"/rest-api/endpoint-reference/entries/create-an-entry-add-record-to-list"},{"title":"Get a list entry","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/lists/{list}/entries/{entry_id}","href":"/rest-api/endpoint-reference/entries/get-a-list-entry"},{"title":"Update a list entry (overwrite multiselect values)","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api put /v2/lists/{list}/entries/{entry_id}","href":"/rest-api/endpoint-reference/entries/update-a-list-entry-overwrite-multiselect-values"},{"title":"Delete a list entry","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api delete /v2/lists/{list}/entries/{entry_id}","href":"/rest-api/endpoint-reference/entries/delete-a-list-entry"},{"title":"Update a list entry (append multiselect values)","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/lists/{list}/entries/{entry_id}","href":"/rest-api/endpoint-reference/entries/update-a-list-entry-append-multiselect-values"},{"title":"List attribute values for a list entry","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/lists/{list}/entries/{entry_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/entries/list-attribute-values-for-a-list-entry"},{"title":"Write list entry attribute values","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api put /v2/lists/{list}/entries/{entry_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/entries/write-list-entry-attribute-values"}]},{"group":"Workspace members","pages":[{"title":"List workspace members","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/workspace_members","href":"/rest-api/endpoint-reference/workspace-members/list-workspace-members"},{"title":"Get a workspace member","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/workspace_members/{workspace_member_id}","href":"/rest-api/endpoint-reference/workspace-members/get-a-workspace-member"}]},{"group":"Notes","pages":[{"title":"List notes","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/notes","href":"/rest-api/endpoint-reference/notes/list-notes"},{"title":"Create a note","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/notes","href":"/rest-api/endpoint-reference/notes/create-a-note"},{"title":"Get a note","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/notes/{note_id}","href":"/rest-api/endpoint-reference/notes/get-a-note"},{"title":"Delete a note","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api delete /v2/notes/{note_id}","href":"/rest-api/endpoint-reference/notes/delete-a-note"},{"title":"Update a note","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/notes/{note_id}","href":"/rest-api/endpoint-reference/notes/update-a-note"}]},{"group":"Tasks","pages":[{"title":"List tasks","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/tasks","href":"/rest-api/endpoint-reference/tasks/list-tasks"},{"title":"Create a task","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/tasks","href":"/rest-api/endpoint-reference/tasks/create-a-task"},{"title":"Get a task","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/tasks/{task_id}","href":"/rest-api/endpoint-reference/tasks/get-a-task"},{"title":"Delete a task","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api delete /v2/tasks/{task_id}","href":"/rest-api/endpoint-reference/tasks/delete-a-task"},{"title":"Update a task","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/tasks/{task_id}","href":"/rest-api/endpoint-reference/tasks/update-a-task"}]},{"group":"Threads","pages":[{"title":"List threads","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/threads","href":"/rest-api/endpoint-reference/threads/list-threads"},{"title":"Get a thread and its comments","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/threads/{thread_id}","href":"/rest-api/endpoint-reference/threads/get-a-thread-and-its-comments"}]},{"group":"Comments","pages":[{"title":"Create a comment","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/comments","href":"/rest-api/endpoint-reference/comments/create-a-comment"},{"title":"Get a comment","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/comments/{comment_id}","href":"/rest-api/endpoint-reference/comments/get-a-comment"},{"title":"Delete a comment","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api delete /v2/comments/{comment_id}","href":"/rest-api/endpoint-reference/comments/delete-a-comment"}]},{"group":"Emails","pages":[{"title":"List emails","deprecated":null,"version":null,"tag":"ALPHA","openapi":"https://api.attio.com/openapi/api get /v2/emails","href":"/rest-api/endpoint-reference/emails/list-emails"}]},{"group":"Sequences","pages":[{"title":"Add emails to the unsubscribe list","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/sequences/unsubscribed_emails","href":"/rest-api/endpoint-reference/sequences/add-emails-to-the-unsubscribe-list"}]},{"group":"Meetings","pages":[{"title":"List meetings","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/meetings","href":"/rest-api/endpoint-reference/meetings/list-meetings"},{"title":"Create a meeting","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/meetings","href":"/rest-api/endpoint-reference/meetings/create-a-meeting"},{"title":"Get a meeting","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/meetings/{meeting_id}","href":"/rest-api/endpoint-reference/meetings/get-a-meeting"},{"title":"Update a meeting (overwrite linked records)","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api put /v2/meetings/{meeting_id}","href":"/rest-api/endpoint-reference/meetings/update-a-meeting-overwrite-linked-records"},{"title":"Delete a meeting","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api delete /v2/meetings/{meeting_id}","href":"/rest-api/endpoint-reference/meetings/delete-a-meeting"},{"title":"Update a meeting (append linked records)","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api patch /v2/meetings/{meeting_id}","href":"/rest-api/endpoint-reference/meetings/update-a-meeting-append-linked-records"}]},{"group":"Call recordings","pages":[{"title":"List call recordings","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/meetings/{meeting_id}/call_recordings","href":"/rest-api/endpoint-reference/call-recordings/list-call-recordings"},{"title":"Create call recording","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/meetings/{meeting_id}/call_recordings","href":"/rest-api/endpoint-reference/call-recordings/create-call-recording"},{"title":"Get call recording","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/meetings/{meeting_id}/call_recordings/{call_recording_id}","href":"/rest-api/endpoint-reference/call-recordings/get-call-recording"},{"title":"Delete call recording","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api delete /v2/meetings/{meeting_id}/call_recordings/{call_recording_id}","href":"/rest-api/endpoint-reference/call-recordings/delete-call-recording"}]},{"group":"Transcripts","pages":[]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/files","href":"/rest-api/endpoint-reference/files/list-files"},{"title":"Create a folder","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/files","href":"/rest-api/endpoint-reference/files/create-a-folder"},{"title":"Upload a file","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api post /v2/files/upload","href":"/rest-api/endpoint-reference/files/upload-a-file"},{"title":"Get a file","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/files/{file_id}","href":"/rest-api/endpoint-reference/files/get-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api delete /v2/files/{file_id}","href":"/rest-api/endpoint-reference/files/delete-a-file"},{"title":"Download a file","deprecated":null,"version":null,"tag":"BETA","openapi":"https://api.attio.com/openapi/api get /v2/files/{file_id}/download","href":"/rest-api/endpoint-reference/files/download-a-file"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/webhooks","href":"/rest-api/endpoint-reference/webhooks/list-webhooks"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api post /v2/webhooks","href":"/rest-api/endpoint-reference/webhooks/create-a-webhook"},{"title":"Get a webhook","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/webhooks/{webhook_id}","href":"/rest-api/endpoint-reference/webhooks/get-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api delete /v2/webhooks/{webhook_id}","href":"/rest-api/endpoint-reference/webhooks/delete-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api patch /v2/webhooks/{webhook_id}","href":"/rest-api/endpoint-reference/webhooks/update-a-webhook"}]},{"group":"Meta","pages":[{"title":"Identify","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/api get /v2/self","href":"/rest-api/endpoint-reference/meta/identify"}]}]},{"group":"Standard objects","pages":[{"group":"People","pages":[{"title":"List person records ","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/people/records/query","href":"/rest-api/endpoint-reference/people/list-person-records"},{"title":"Upsert a person record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects put /v2/objects/people/records","href":"/rest-api/endpoint-reference/people/upsert-a-person-record"},{"title":"Create a person Record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/people/records","href":"/rest-api/endpoint-reference/people/create-a-person-record"},{"title":"Get a person Record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/people/records/{record_id}","href":"/rest-api/endpoint-reference/people/get-a-person-record"},{"title":"Delete a person Record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects delete /v2/objects/people/records/{record_id}","href":"/rest-api/endpoint-reference/people/delete-a-person-record"},{"title":"Update a person Record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects patch /v2/objects/people/records/{record_id}","href":"/rest-api/endpoint-reference/people/update-a-person-record"},{"title":"List person record attribute values","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/people/records/{record_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/people/list-person-record-attribute-values"},{"title":"List person record entries","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/people/records/{record_id}/entries","href":"/rest-api/endpoint-reference/people/list-person-record-entries"}]},{"group":"Companies","pages":[{"title":"List company records","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/companies/records/query","href":"/rest-api/endpoint-reference/companies/list-company-records"},{"title":"Upsert a company record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects put /v2/objects/companies/records","href":"/rest-api/endpoint-reference/companies/upsert-a-company-record"},{"title":"Create a company record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/companies/records","href":"/rest-api/endpoint-reference/companies/create-a-company-record"},{"title":"Get a company record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/companies/records/{record_id}","href":"/rest-api/endpoint-reference/companies/get-a-company-record"},{"title":"Delete a company record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects delete /v2/objects/companies/records/{record_id}","href":"/rest-api/endpoint-reference/companies/delete-a-company-record"},{"title":"Update a company record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects patch /v2/objects/companies/records/{record_id}","href":"/rest-api/endpoint-reference/companies/update-a-company-record"},{"title":"List company record attribute values","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/companies/records/{record_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/companies/list-company-record-attribute-values"},{"title":"List company record entries","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/companies/records/{record_id}/entries","href":"/rest-api/endpoint-reference/companies/list-company-record-entries"}]},{"group":"Users","pages":[{"title":"List user records","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/users/records/query","href":"/rest-api/endpoint-reference/users/list-user-records"},{"title":"Upsert a user record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects put /v2/objects/users/records","href":"/rest-api/endpoint-reference/users/upsert-a-user-record"},{"title":"Create a user record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/users/records","href":"/rest-api/endpoint-reference/users/create-a-user-record"},{"title":"Get a user record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/users/records/{record_id}","href":"/rest-api/endpoint-reference/users/get-a-user-record"},{"title":"Delete a user record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects delete /v2/objects/users/records/{record_id}","href":"/rest-api/endpoint-reference/users/delete-a-user-record"},{"title":"Update a user Record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects patch /v2/objects/users/records/{record_id}","href":"/rest-api/endpoint-reference/users/update-a-user-record"},{"title":"List user record attribute values","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/users/records/{record_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/users/list-user-record-attribute-values"},{"title":"List user record entries","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/users/records/{record_id}/entries","href":"/rest-api/endpoint-reference/users/list-user-record-entries"}]},{"group":"Deals","pages":[{"title":"Upsert a deal record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects put /v2/objects/deals/records","href":"/rest-api/endpoint-reference/deals/upsert-a-deal-record"},{"title":"Create a deal record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/deals/records","href":"/rest-api/endpoint-reference/deals/create-a-deal-record"},{"title":"Get a deal record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/deals/records/{record_id}","href":"/rest-api/endpoint-reference/deals/get-a-deal-record"},{"title":"Delete a deal record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects delete /v2/objects/deals/records/{record_id}","href":"/rest-api/endpoint-reference/deals/delete-a-deal-record"},{"title":"Update a deal record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects patch /v2/objects/deals/records/{record_id}","href":"/rest-api/endpoint-reference/deals/update-a-deal-record"},{"title":"List deal record attribute values","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/deals/records/{record_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/deals/list-deal-record-attribute-values"},{"title":"List deal record entries","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/deals/records/{record_id}/entries","href":"/rest-api/endpoint-reference/deals/list-deal-record-entries"},{"title":"List deal records","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/deals/records/query","href":"/rest-api/endpoint-reference/deals/list-deal-records"}]},{"group":"Workspaces","pages":[{"title":"Upsert a workspace record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects put /v2/objects/workspaces/records","href":"/rest-api/endpoint-reference/workspaces/upsert-a-workspace-record"},{"title":"Create a workspace record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/workspaces/records","href":"/rest-api/endpoint-reference/workspaces/create-a-workspace-record"},{"title":"Get a workspace record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/workspaces/records/{record_id}","href":"/rest-api/endpoint-reference/workspaces/get-a-workspace-record"},{"title":"Delete a workspace record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects delete /v2/objects/workspaces/records/{record_id}","href":"/rest-api/endpoint-reference/workspaces/delete-a-workspace-record"},{"title":"Update a workspace Record","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects patch /v2/objects/workspaces/records/{record_id}","href":"/rest-api/endpoint-reference/workspaces/update-a-workspace-record"},{"title":"List workspace record attribute values","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/workspaces/records/{record_id}/attributes/{attribute}/values","href":"/rest-api/endpoint-reference/workspaces/list-workspace-record-attribute-values"},{"title":"List workspace record entries","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects get /v2/objects/workspaces/records/{record_id}/entries","href":"/rest-api/endpoint-reference/workspaces/list-workspace-record-entries"},{"title":"List workspace records","deprecated":null,"version":null,"openapi":"https://api.attio.com/openapi/standard-objects post /v2/objects/workspaces/records/query","href":"/rest-api/endpoint-reference/workspaces/list-workspace-records"}]}]},{"group":"SCIM 2.0","pages":[{"title":"List SCIM schemas","api":"GET https://api.attio.com/scim/v2/Schemas","href":"/rest-api/scim/list-schemas"},{"group":"Users","pages":[{"title":"Create a SCIM user","api":"POST https://api.attio.com/scim/v2/Users","href":"/rest-api/scim/create-user"},{"title":"Get a SCIM user","api":"GET https://api.attio.com/scim/v2/Users/{user_id}","href":"/rest-api/scim/get-user-by-id"},{"title":"List SCIM users","api":"GET https://api.attio.com/scim/v2/Users","href":"/rest-api/scim/list-users"},{"title":"Update a SCIM user","api":"PUT https://api.attio.com/scim/v2/Users/{user_id}","href":"/rest-api/scim/update-user"},{"title":"Patch a SCIM user","api":"PATCH https://api.attio.com/scim/v2/Users/{user_id}","href":"/rest-api/scim/patch-user"},{"title":"Delete a SCIM user","api":"DELETE https://api.attio.com/scim/v2/Users/{user_id}","href":"/rest-api/scim/delete-user"}]},{"group":"Groups","pages":[{"title":"Create a SCIM group","api":"POST https://api.attio.com/scim/v2/Groups","href":"/rest-api/scim/create-group"},{"title":"Get a SCIM group","api":"GET https://api.attio.com/scim/v2/Groups/{workspace_team_id}","href":"/rest-api/scim/get-group-by-id"},{"title":"List SCIM groups","api":"GET https://api.attio.com/scim/v2/Groups","href":"/rest-api/scim/list-groups"},{"title":"Update a SCIM group","api":"PUT https://api.attio.com/scim/v2/Groups/{workspace_team_id}","href":"/rest-api/scim/update-group"},{"title":"Patch a SCIM group","api":"PATCH https://api.attio.com/scim/v2/Groups/{workspace_team_id}","href":"/rest-api/scim/patch-group"},{"title":"Delete a SCIM group","api":"DELETE https://api.attio.com/scim/v2/Groups/{workspace_team_id}","href":"/rest-api/scim/delete-group"}]}]},{"group":"OAuth 2.0","pages":[{"title":"Authorize","api":"GET https://app.attio.com/authorize","href":"/docs/oauth/authorize"},{"title":"Token","api":"POST https://app.attio.com/oauth/token","href":"/docs/oauth/token"},{"title":"Introspect","api":"POST https://app.attio.com/oauth/introspect","href":"/docs/oauth/introspect"},{"title":"Revoke","api":"POST https://app.attio.com/oauth/revoke","href":"/docs/oauth/revoke"}]}]},{"group":"Webhook reference","pages":[{"group":"Activity events","pages":[{"title":"Activity created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook activity.created","href":"/rest-api/webhook-reference/activity-events/activitycreated"},{"title":"Activity updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook activity.updated","href":"/rest-api/webhook-reference/activity-events/activityupdated"},{"title":"Activity deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook activity.deleted","href":"/rest-api/webhook-reference/activity-events/activitydeleted"}]},{"group":"Activity attribute events","pages":[{"title":"Activity attribute created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook activity-attribute.created","href":"/rest-api/webhook-reference/activity-attribute-events/activity-attributecreated"},{"title":"Activity attribute updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook activity-attribute.updated","href":"/rest-api/webhook-reference/activity-attribute-events/activity-attributeupdated"}]},{"group":"Activity record events","pages":[{"title":"Activity record created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook activity-record.created","href":"/rest-api/webhook-reference/activity-record-events/activity-recordcreated"},{"title":"Activity record deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook activity-record.deleted","href":"/rest-api/webhook-reference/activity-record-events/activity-recorddeleted"}]},{"group":"Call recording events","pages":[{"title":"Call recording created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook call-recording.created","href":"/rest-api/webhook-reference/call-recording-events/call-recordingcreated"}]},{"group":"Comment events","pages":[{"title":"Comment created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook comment.created","href":"/rest-api/webhook-reference/comment-events/commentcreated"},{"title":"Comment resolved","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook comment.resolved","href":"/rest-api/webhook-reference/comment-events/commentresolved"},{"title":"Comment unresolved","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook comment.unresolved","href":"/rest-api/webhook-reference/comment-events/commentunresolved"},{"title":"Comment deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook comment.deleted","href":"/rest-api/webhook-reference/comment-events/commentdeleted"}]},{"group":"List events","pages":[{"title":"List created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list.created","href":"/rest-api/webhook-reference/list-events/listcreated"},{"title":"List updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list.updated","href":"/rest-api/webhook-reference/list-events/listupdated"},{"title":"List deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list.deleted","href":"/rest-api/webhook-reference/list-events/listdeleted"}]},{"group":"List attribute events","pages":[{"title":"List attribute created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list-attribute.created","href":"/rest-api/webhook-reference/list-attribute-events/list-attributecreated"},{"title":"List attribute updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list-attribute.updated","href":"/rest-api/webhook-reference/list-attribute-events/list-attributeupdated"}]},{"group":"List entry events","pages":[{"title":"List entry created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list-entry.created","href":"/rest-api/webhook-reference/list-entry-events/list-entrycreated"},{"title":"List entry updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list-entry.updated","href":"/rest-api/webhook-reference/list-entry-events/list-entryupdated"},{"title":"List entry deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook list-entry.deleted","href":"/rest-api/webhook-reference/list-entry-events/list-entrydeleted"}]},{"group":"Object attribute events","pages":[{"title":"Object attribute created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook object-attribute.created","href":"/rest-api/webhook-reference/object-attribute-events/object-attributecreated"},{"title":"Object attribute updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook object-attribute.updated","href":"/rest-api/webhook-reference/object-attribute-events/object-attributeupdated"}]},{"group":"Note events","pages":[{"title":"Note created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook note.created","href":"/rest-api/webhook-reference/note-events/notecreated"},{"title":"Note updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook note.updated","href":"/rest-api/webhook-reference/note-events/noteupdated"},{"title":"Note deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook note.deleted","href":"/rest-api/webhook-reference/note-events/notedeleted"}]},{"group":"Note content events","pages":[{"title":"Note content updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook note-content.updated","href":"/rest-api/webhook-reference/note-content-events/note-contentupdated"}]},{"group":"Record events","pages":[{"title":"Record created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook record.created","href":"/rest-api/webhook-reference/record-events/recordcreated"},{"title":"Record merged","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook record.merged","href":"/rest-api/webhook-reference/record-events/recordmerged"},{"title":"Record updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook record.updated","href":"/rest-api/webhook-reference/record-events/recordupdated"},{"title":"Record deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook record.deleted","href":"/rest-api/webhook-reference/record-events/recorddeleted"}]},{"group":"Task events","pages":[{"title":"Task created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook task.created","href":"/rest-api/webhook-reference/task-events/taskcreated"},{"title":"Task updated","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook task.updated","href":"/rest-api/webhook-reference/task-events/taskupdated"},{"title":"Task deleted","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook task.deleted","href":"/rest-api/webhook-reference/task-events/taskdeleted"}]},{"group":"Workspace member events","pages":[{"title":"Workspace member created","version":null,"deprecated":null,"openapi":"https://api.attio.com/openapi/webhooks webhook workspace-member.created","href":"/rest-api/webhook-reference/workspace-member-events/workspace-membercreated"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"SQL","pages":[{"title":"SQL","href":"/sql/overview"}]},{"tab":"Share","pages":[{"title":"Share","href":"/share/the-publication-lifecycle"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/app-sdk"}]}]},"basePath":"","title":"Update a list - Attio Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}