1. Core Data
    2. /Object

    Object

    Objects are the core data models inside of Attio. They contain both Attio-defined objects such as the Person and Company objects, and user-defined objects that are specific to your use-case.


    List Objects

    Lists all system-defined and user-defined objects in your workspace, including their defined attributes.

    Scopes

    • object_configuration:readrequired

    Response

    Status code

    Description


    Request

    GET
    /v2/objects
    curl https://api.attio.com/v2/objects \
    -H "Authorization: Bearer <token>"

    Response

    200 - Success

    {
    "data": [
    {
    "id": {
    "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
    "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c"
    },
    "api_slug": "person",
    "created_at": "2022-11-21T13:22:49.061281000Z",
    "plural_noun": "People",
    "singular_noun": "Person"
    }
    ]
    }

    Get an Object

    Gets a single Object by its object_id or slug.

    Scopes

    • object_configuration:readrequired

    Path params

    objectstring

    REQUIRED

    A UUID or slug to identify the Object.

    Response

    Status code

    Description



    Request

    GET
    /v2/objects/:object
    curl https://api.attio.com/v2/objects/people \
    -H "Authorization: Bearer <token>"

    Response

    200 - Success

    {
    "data": {
    "id": {
    "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
    "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c"
    },
    "api_slug": "person",
    "created_at": "2022-11-21T13:22:49.061281000Z",
    "plural_noun": "People",
    "singular_noun": "Person"
    }
    }