{% extends "docs/base.html" %}

{% block docs_content %}
  <div class="mb-4">
    <h1 class="h3 mb-1">Get team activity</h1>
    <p class="text-muted mb-0">List the current activity of all active members of a team.</p>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Endpoint</h2>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>GET /api/v1/teams/{team_slug}/activity</code></pre>
      </div>
      <div class="mt-2 d-flex gap-2">
        <span class="badge text-bg-secondary">Authenticated</span>
      </div>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Query Parameters</h2>
      <ul class="mb-0">
        <li><code>sort</code> &mdash; one of <code>activity_updated_at</code> (ascending) or <code>-activity_updated_at</code> (descending, default).</li>
        <li><code>page</code> / <code>per_page</code> &mdash; standard page-based pagination.</li>
      </ul>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Usage</h2>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>curl \
  --header "Authorization: Bearer $PEARING_API_TOKEN" \
  "$PEARING_API_URL/v1/teams/pearing/activity"

curl \
  --header "Authorization: Bearer $PEARING_API_TOKEN" \
  "$PEARING_API_URL/v1/teams/pearing/activity?sort=activity_updated_at"</code></pre>
      </div>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Success</h2>
      <p class="mb-2"><code>200 OK</code> with a paginated list of team member activities.</p>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>{
  "next": null,
  "previous": null,
  "results": [
    {
      "user_uuid": "6bd57c93-1acb-42ec-92d3-e817a6076fd4",
      "user_username": "alice",
      "user_name": "Alice",
      "activity": "Working on mentions",
      "activity_updated_at": "2026-03-20T16:00:00Z"
    }
  ]
}</code></pre>
      </div>
      <p class="text-muted mt-2 mb-0">All active team members are returned even if they have no activity. Members without activity have an empty <code>activity</code> string and a <code>null</code> <code>activity_updated_at</code>.</p>
    </div>
  </div>

  <div class="card shadow-sm">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Errors</h2>
      <ul class="mb-0">
        <li><code>400 Bad Request</code> with <code>invalid_sort</code> when <code>sort</code> is not a recognized value.</li>
        <li><code>403 Forbidden</code> with <code>staff_or_member</code> when the authenticated user is not a member of the team.</li>
        <li><code>404 Not Found</code> when the team does not exist or is inactive.</li>
      </ul>
      <p class="text-muted mt-2 mb-0">Common auth errors are documented on the API overview page.</p>
    </div>
  </div>
{% endblock %}