AttioInstall

Overview

This node operation retrieves the statuses of a specific status attribute associated with either an object or a list in Attio. It is useful when you want to inspect or manage the possible statuses defined for a particular attribute on a target entity, such as a list or an object (except company and people objects which do not support status attributes currently).

Common scenarios:

• Fetching all available statuses for a custom status attribute on a list to display or process them downstream.
• Checking archived vs active statuses for audit or cleanup purposes.
• Integrating with workflows that depend on the current set of statuses for a given attribute.

Example:
You have a list identified by a UUID and a status attribute on that list. You want to get all statuses including archived ones to show in a dashboard or to decide which statuses can be assigned to entries.

Properties

Output

The output is a JSON object representing the response from the Attio API endpoint that lists the statuses of the specified status attribute. The structure typically includes an array of status objects, each describing a status with properties such as its ID, name, color, order, and whether it is archived.

Example output structure (simplified):

{
  "statuses": [
    {
      "id": "status-uuid",
      "name": "Status Name",
      "color": "#hexcode",
      "order": 1,
      "archived": false
    },
    ...
  ]
}

No binary data is returned by this operation.

Dependencies

• Requires an API key credential for authenticating with the Attio API.
• The node makes HTTP requests to the Attio API endpoint:
  GET https://api.attio.com/v2/{target}/{identifier}/attributes/{attribute}/statuses
• The user must configure the node with valid credentials and provide correct identifiers for target, object/list, and attribute.

Troubleshooting

• Invalid Identifier or Attribute: If the provided UUID or slug for the target, identifier, or attribute is incorrect or does not exist, the API will return an error. Verify the IDs are correct.
• Unsupported Target: Using "objects" as target for company or people objects will fail because they do not support status attributes. Use "lists" instead if applicable.
• Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
• Empty Results: If no statuses are returned, check if the attribute actually has statuses defined or if filtering by archived statuses excludes all results.
• Network Issues: Check connectivity to the Attio API endpoint.

Links and References

• Attio API Documentation - Attributes
• Archiving Guide (for understanding the show_archived property)