action attio_get_list {
  label: "Get a list"
  description: "Gets a single list in your workspace that your access token has access to.\n\nRequired scopes: `list_configuration:read`."
  provider: attio
  method: GET
  path: "/v2/lists/{list}"
  encoding: json
  scopes: ["list_configuration:read"]
  input: {
    type: "object"
    properties: {
      list: {
        type: "string"
        description: "A UUID or slug to identify the list."
      }
    }
    required: ["list"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Success"
    required: ["data"]
    properties: {
      data: {
        type: "object"
        required: ["api_slug", "created_at", "created_by_actor", "id", "name", "parent_object", "workspace_access", "workspace_member_access"]
        properties: {
          api_slug: {
            type: "string"
            description: "A human-readable slug for use in URLs and responses."
          }
          created_at: {
            type: "string"
            description: "When the list was created."
          }
          created_by_actor: {
            type: "object"
            description: "The actor which created this list."
            properties: {
              id: {
                type: "string"
                description: "An ID to identify the actor."
              }
              type: {
                type: "string"
                description: "The type of actor. [Read more information on actor types here](/docs/actors)."
                enum: ["api-token", "workspace-member", "system", "app"]
              }
            }
          }
          id: {
            type: "object"
            required: ["list_id", "workspace_id"]
            properties: {
              list_id: {
                type: "string"
                format: "uuid"
                description: "A UUID to identify this list."
              }
              workspace_id: {
                type: "string"
                format: "uuid"
                description: "A UUID to identify the workspace this list belongs to."
              }
            }
          }
          name: {
            type: "string"
            description: "The name of the list, as viewed in the UI."
          }
          parent_object: {
            type: "array"
            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."
            items: {
              type: "string"
            }
          }
          workspace_access: {
            type: ["string", "null"]
            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."
            enum: ["full-access", "read-and-write", "read-only"]
          }
          workspace_member_access: {
            type: "array"
            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."
            items: {
              type: "object"
              required: ["workspace_member_id", "level"]
              properties: {
                level: {
                  type: "string"
                  description: "The level of access to the list."
                  enum: ["full-access", "read-and-write", "read-only"]
                }
                workspace_member_id: {
                  type: "string"
                  format: "uuid"
                  description: "A UUID to identify the workspace member to grant access to."
                }
              }
            }
          }
        }
      }
    }
  }
}