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

# Talents API

> Browse talent groups and categories in the community

## GET /api/talents

Retrieve talent groups and categories from the Dzaleka talent directory.

### Query Parameters

No query parameters required. Returns all talent groups.

### Response Format

<ResponseField name="status" type="string" required>
  Status of the API response ("success" or "error")
</ResponseField>

<ResponseField name="count" type="number" required>
  Total number of talent groups returned
</ResponseField>

<ResponseField name="data" type="object" required>
  Container for the talents data

  <ResponseField name="talents" type="array" required>
    Array of talent group objects

    <ResponseField name="id" type="string">
      Unique talent group identifier
    </ResponseField>

    <ResponseField name="name" type="string">
      Group or category name
    </ResponseField>

    <ResponseField name="category" type="string">
      Talent category (e.g., "Arts", "Music", "Sports")
    </ResponseField>

    <ResponseField name="profilePic" type="string">
      URL to group profile image
    </ResponseField>

    <ResponseField name="talents" type="array">
      Array of individual talents within the group

      <ResponseField name="name" type="string">
        Talent name
      </ResponseField>

      <ResponseField name="bio" type="string">
        Talent biography
      </ResponseField>

      <ResponseField name="profilePic" type="string">
        Individual profile picture
      </ResponseField>

      <ResponseField name="instagram" type="string">
        Instagram handle
      </ResponseField>

      <ResponseField name="twitter" type="string">
        Twitter handle
      </ResponseField>
    </ResponseField>
  </ResponseField>
</ResponseField>

### Example Request

```bash theme={null}
curl https://services.dzaleka.com/api/talents
```

### Example Response

```json theme={null}
{
  "status": "success",
  "count": 8,
  "data": {
    "talents": [
      {
        "id": "visual-artists",
        "name": "Visual Artists",
        "category": "Arts",
        "profilePic": "/images/talents/visual-artists.jpg",
        "talents": [
          {
            "name": "Marie Kibwe",
            "bio": "Contemporary painter specializing in abstract expressionism",
            "profilePic": "/images/artists/marie.jpg",
            "instagram": "@mariekibwe",
            "twitter": "@mariekibwe"
          }
        ]
      }
    ]
  }
}
```

## POST /api/talents

Submit talent data with optional metadata.

### Headers

* `Content-Type: application/json` (required)

### Response

Returns the same format as GET with additional metadata if provided.

## Related Endpoints

<CardGroup cols={2}>
  <Card title="Profiles API" icon="user" href="/api/profiles">
    View individual member profiles
  </Card>

  <Card title="Artists" icon="palette" href="/heritage/artists">
    Browse artist profiles
  </Card>
</CardGroup>