List select options

v1.0.0

Lists all select options for a particular attribute on either an object or a list.

When target is objects, the required scopes are object_configuration:read. When target is lists, the required scopes are list_configuration:read.

Input

{
  "type": "object",
  "properties": {
    "attribute": {
      "type": "string",
      "description": "A UUID or slug to identify the attribute you want to list select options on."
    },
    "identifier": {
      "type": "string",
      "description": "A UUID or slug to identify the object or list the select attribute belongs to."
    },
    "show_archived": {
      "type": "boolean",
      "description": "`true` if you want the results to include archived select options."
    },
    "target": {
      "type": "string",
      "description": "Whether the attribute is on an object or a list.",
      "enum": [
        "objects",
        "lists"
      ]
    }
  },
  "required": [
    "attribute",
    "identifier",
    "target"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Success",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "title",
          "is_archived"
        ],
        "properties": {
          "id": {
            "type": "object",
            "required": [
              "workspace_id",
              "object_id",
              "attribute_id",
              "option_id"
            ],
            "properties": {
              "attribute_id": {
                "type": "string",
                "format": "uuid",
                "description": "The ID of the attribute"
              },
              "object_id": {
                "type": "string",
                "format": "uuid",
                "description": "The ID of the object"
              },
              "option_id": {
                "type": "string",
                "format": "uuid",
                "description": "The ID of the select option"
              },
              "workspace_id": {
                "type": "string",
                "format": "uuid",
                "description": "The ID of the workspace"
              }
            }
          },
          "is_archived": {
            "type": "boolean",
            "description": "Whether or not to archive the select option. See our [archiving guide](/docs/archiving-vs-deleting) for more information on archiving."
          },
          "title": {
            "type": "string",
            "description": "The title of the select option"
          }
        }
      }
    }
  }
}