{"openapi":"3.1.0","info":{"title":"Attio Schema (BYOK) API","version":"0.1.0","description":"Attio Schema (BYOK) lets an AI assistant read your own Attio Schema data through the Attio Schema API with a key you supply (Attio API key (access token)). Read-only: 9 tools (get_object, list_object_attributes, list_list_attributes, list_object_select_options, list_list_select_options, list_object_statuses, list_list_statuses, list_object_views, list_list_views). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-attio-schema.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-attio-schema/docs"},"termsOfService":"https://connectorbay.com/byok-attio-schema/terms"},"servers":[{"url":"https://byok-attio-schema.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-attio-schema/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_object":{"post":{"operationId":"get_object","summary":"Get one object definition: api slug, singular and plural names and creation time. Needs the object_configuration:read sc","description":"Get one object definition: api slug, singular and plural names and creation time. Needs the object_configuration:read scope. Use for \"What are the singular and plural names of the Attio companies object\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"object":{"description":"Object api slug or id, for example 'people', 'companies' or 'deals'.","maxLength":80,"title":"Object","type":"string"}},"required":["object"],"title":"get_objectArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_object_attributes":{"post":{"operationId":"list_object_attributes","summary":"List the attributes (fields) defined on an object with title, api slug, type, description and flags for required, unique","description":"List the attributes (fields) defined on an object with title, api slug, type, description and flags for required, unique, multi-select, writable, system and archived. Needs the object_configuration:read scope. Use for \"What fields does the Attio companies object have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"object":{"description":"Object api slug or id, for example 'people', 'companies' or 'deals'.","maxLength":80,"title":"Object","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many attributes to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many attributes to skip, for paging.","title":"Offset"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["object"],"title":"list_object_attributesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_list_attributes":{"post":{"operationId":"list_list_attributes","summary":"List the attributes (columns) defined on a list with title, api slug, type and flags for required, unique, multi-select,","description":"List the attributes (columns) defined on a list with title, api slug, type and flags for required, unique, multi-select, writable and archived. Needs the list_configuration:read scope. Use for \"What columns does my Attio sales pipeline list have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"list":{"description":"List api slug or id, for example 'sales_pipeline'.","maxLength":80,"title":"List","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many attributes to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many attributes to skip, for paging.","title":"Offset"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["list"],"title":"list_list_attributesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_object_select_options":{"post":{"operationId":"list_object_select_options","summary":"List the options of a select attribute on an object, with title and archived flag. Use for \"Which industry options exist","description":"List the options of a select attribute on an object, with title and archived flag. Use for \"Which industry options exist on Attio companies\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"object":{"description":"Object api slug or id, for example 'people', 'companies' or 'deals'.","maxLength":80,"title":"Object","type":"string"},"attribute":{"description":"Attribute api slug or id, for example 'stage'.","maxLength":80,"title":"Attribute","type":"string"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["object","attribute"],"title":"list_object_select_optionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_list_select_options":{"post":{"operationId":"list_list_select_options","summary":"List the options of a select attribute on a list, with title and archived flag. Use for \"Which source options does my At","description":"List the options of a select attribute on a list, with title and archived flag. Use for \"Which source options does my Attio list column offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"list":{"description":"List api slug or id, for example 'sales_pipeline'.","maxLength":80,"title":"List","type":"string"},"attribute":{"description":"Attribute api slug or id, for example 'stage'.","maxLength":80,"title":"Attribute","type":"string"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["list","attribute"],"title":"list_list_select_optionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_object_statuses":{"post":{"operationId":"list_object_statuses","summary":"List the statuses of a status attribute on an object with title, archived flag, celebration flag and target time in stat","description":"List the statuses of a status attribute on an object with title, archived flag, celebration flag and target time in status. Use for \"Which statuses can an Attio company have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"object":{"description":"Object api slug or id, for example 'people', 'companies' or 'deals'.","maxLength":80,"title":"Object","type":"string"},"attribute":{"description":"Attribute api slug or id, for example 'stage'.","maxLength":80,"title":"Attribute","type":"string"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["object","attribute"],"title":"list_object_statusesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_list_statuses":{"post":{"operationId":"list_list_statuses","summary":"List the statuses of a status attribute on a list (for example pipeline stages) with title, archived flag, celebration f","description":"List the statuses of a status attribute on a list (for example pipeline stages) with title, archived flag, celebration flag and target time in status. Use for \"What are the stages of my Attio sales pipeline list\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"list":{"description":"List api slug or id, for example 'sales_pipeline'.","maxLength":80,"title":"List","type":"string"},"attribute":{"description":"Attribute api slug or id, for example 'stage'.","maxLength":80,"title":"Attribute","type":"string"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["list","attribute"],"title":"list_list_statusesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_object_views":{"post":{"operationId":"list_object_views","summary":"List saved table or board views of an object with title and creation time. Use for \"Which saved views exist for Attio co","description":"List saved table or board views of an object with title and creation time. Use for \"Which saved views exist for Attio companies\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"object":{"description":"Object api slug or id, for example 'people', 'companies' or 'deals'.","maxLength":80,"title":"Object","type":"string"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many views to return (1 to 1000).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from pagination.next_cursor of the previous answer.","title":"Cursor"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["object"],"title":"list_object_viewsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_list_views":{"post":{"operationId":"list_list_views","summary":"List saved table or board views of a list with title and creation time. Use for \"Which saved views exist for my Attio sa","description":"List saved table or board views of a list with title and creation time. Use for \"Which saved views exist for my Attio sales pipeline list\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"list":{"description":"List api slug or id, for example 'sales_pipeline'.","maxLength":80,"title":"List","type":"string"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many views to return (1 to 1000).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from pagination.next_cursor of the previous answer.","title":"Cursor"},"show_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived entries.","title":"Show Archived"}},"required":["list"],"title":"list_list_viewsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}