---
title: "List your organizations with OKFIndex enabled."
method: GET
path: "/api/teams"
---

# List your organizations with OKFIndex enabled.

`GET /api/teams`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/teams`
- Auth: none declared

Team access uses current account membership, product access and resource sharing on every request. Revocation also blocks search, originals, Markdown, OKF and ZIP downloads with an existing session or key. Sharing a collection grants current and future files in its owner's referenced bases; other owners' bases expose published files only. Sharing does not publish a resource. Only the resource owner changes sharing. The initial grant requires the owner's session with origin and CSRF checks. Organization API keys stay within their existing grants. Responses use private, no-store.
Returns: { items[{id,nome,papel,exigeMfa}], truncated }

## Response `200`

{ items[{id,nome,papel,exigeMfa}], truncated }

- object
  - `items` KnowledgeTeam[], required: Organizations available to this credential.
    - `id` string, required: An existing organization ID from list_knowledge_teams. The account must be an active member and OKFIndex must be enabled.
    - `nome` string, nullable, required: Organization name, or null for an organization key.
    - `papel` string, nullable, required: Existing account role, or null for an organization key. Team knowledge remains read-only.
    - `exigeMfa` boolean, required: The account requires a second factor before opening this organization.
  - `truncated` boolean, required: True when the account list reaches its limit.

## Other responses

- `400`: Invalid query or cursor.
- `401`: A valid session or organization API key is required.
- `403`: Organization access requires the correct credential and, when applicable, MFA.
- `404`: The organization, resource or sharing grant is inaccessible.
- `405`: Team access is read-only.
- `409`: A file is not ready for export.
- `503`: Account or knowledge storage is unavailable.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)