> ## Documentation Index
> Fetch the complete documentation index at: https://docs.permutive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Cohort Detail

**Tool name** `get_cohort_detail`

<Info>Read-only · Idempotent</Info>

Returns metadata for specific cohorts: name, type, state, tags, subject entity, description, creation time, owning workspace, and which of the requested workspaces the cohort is available in.

## Example prompt

> What type and state is the "Luxury Auto Intenders" cohort, and which of my workspaces can use it?

## Parameters

<ParamField body="cohort_ids" type="string[]" required>
  Cohort short ids to retrieve metadata for. Obtain these from search\_cohorts. min 1 item.
</ParamField>

<ParamField body="workspace_ids" type="string[]" required>
  Workspaces to look the given cohorts up in. min 1 item.
</ParamField>

## Returns

<ResponseField name="found" type="Found[]">
  Cohorts that were found in the requested workspaces, each with its metadata.

  <Expandable title="Found">
    <ResponseField name="available_in_workspaces" type="string[]" required>
      Which of the requested workspaces this cohort can be used from. Pass any of these to follow-up tools. min 1 item.
    </ResponseField>

    <ResponseField name="cohort_id" type="string" required>
      Cohort short id, matching the input.
    </ResponseField>

    <ResponseField name="cohort_type" type="enum" required>
      Cohort type. one of: `custom`, `lookalike`, `contextual`, `standard`, `classificationModel`, `advertiser`, `curated`.
    </ResponseField>

    <ResponseField name="created_at" type="string (date-time)">
      When the cohort was created (ISO-8601). Absent for cohort types that don't record a creation time (e.g. standard cohorts).
    </ResponseField>

    <ResponseField name="description" type="string">
      Free-text description of the cohort. Absent when the cohort has none.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Human-readable cohort name.
    </ResponseField>

    <ResponseField name="owning_workspace" type="string (uuid)">
      Workspace where this cohort was originally defined.
    </ResponseField>

    <ResponseField name="state" type="string" required>
      Whether the cohort is enabled or disabled.
    </ResponseField>

    <ResponseField name="subject_entity" type="enum" required>
      What the cohort targets: a user, a group of users (ie. a household), or a piece of content. one of: `user`, `user_group`, `content`.
    </ResponseField>

    <ResponseField name="tags" type="string[]">
      Tags applied to the cohort. Empty when the cohort has none.
    </ResponseField>

    <ResponseField name="users" type="integer (int64)" required>
      Estimated unique users in the last 30 days, across the requested workspaces.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="not_found" type="NotFound[]">
  Cohorts that weren't found in any of the requested workspaces.

  <Expandable title="NotFound">
    <ResponseField name="cohort_id" type="string" required>
      Cohort short id that wasn't found.
    </ResponseField>
  </Expandable>
</ResponseField>