> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentsfleet.net/llms.txt > Use this file to discover all available pages before exploring further. # List your workspaces > Lists workspaces across your own account and accounts you joined, oldest first. Each includes the account and your role. API keys and command-line credentials list only their own account. Continue with `next_cursor` as `starting_after`. Use the exact `name` filter to find a workspace after an uncertain create response. `tenant_id` identifies your own account. ## OpenAPI ````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json get /v1/tenants/me/workspaces openapi: 3.1.0 info: title: agentsfleet API description: API for managing workspaces, fleets, triggers, and runs. contact: name: agentsfleet url: https://agentsfleet.net license: name: MIT identifier: MIT version: 1.0.0 servers: - url: https://api.agentsfleet.net description: Production security: [] paths: /v1/tenants/me/workspaces: get: tags: - Workspaces summary: List your workspaces description: >- Lists workspaces across your own account and accounts you joined, oldest first. Each includes the account and your role. API keys and command-line credentials list only their own account. Continue with `next_cursor` as `starting_after`. Use the exact `name` filter to find a workspace after an uncertain create response. `tenant_id` identifies your own account. operationId: list_tenant_workspaces parameters: - name: name in: query description: Exact tenant-scoped workspace name. required: false schema: type: string - name: starting_after in: query description: Cursor returned as `next_cursor` by the previous page. required: false schema: type: string - name: limit in: query description: How many rows to return. required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WorkspacesResponse' '401': description: Authentication is missing, invalid, or not accepted by this endpoint content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '403': description: You do not have permission for this action content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '429': description: A request or capacity limit has been reached content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '500': description: An internal server error occurred content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '503': description: A required service is unavailable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' security: - BearerAuth: [] components: schemas: WorkspacesResponse: type: object description: >- `GET /v1/tenants/me/workspaces` — one page of the workspaces across every account the caller holds. required: - items - tenant_id properties: items: type: array items: $ref: '#/components/schemas/WorkspaceSummary' description: The rows on this page, oldest first. next_cursor: type: - string - 'null' description: Where the next page resumes, or `null` on the last page. tenant_id: type: string description: >- The caller's own account — the authoritative resolution, carried so a client can pin its local state to the right person. Items from accounts the caller joined name theirs in `account`. total: type: - integer - 'null' format: int64 description: |- Always `null`: the walk never counts, and the key stays because a client may already branch on its presence. ProblemBody: type: object description: The body every refusal carries, under `application/problem+json`. required: - docs_uri - title - detail - error_code - request_id properties: action_id: type: - string - 'null' description: 'On that 409 only: the action the gate held.' current_state: type: - string - 'null' description: 'On a 409 only: the state that forbade the transition.' detail: type: string description: One sentence on what was refused and why. docs_uri: type: string description: Where the error code is documented. error_code: type: string description: The registry code, stable across releases. etag: type: - string - 'null' description: >- On a 412 only: the resource's current entity tag, to refetch and retry. gate_id: type: - string - 'null' description: 'On an answered approval gate''s 409 only: the gate that was answered.' outcome: type: - string - 'null' description: 'On that 409 only: the answer that stands.' request_id: type: string description: The request this refusal answers, for support. resolved_at: type: - string - 'null' format: date-time description: 'On that 409 only: when the standing answer was given.' resolved_by: type: - string - 'null' description: 'On that 409 only: who gave it.' title: type: string description: A short name for the refusal, safe to show a person. user_message: type: - string - 'null' description: A curated sentence for end users, where the code has one. WorkspaceSummary: type: object description: One workspace as the list shows it. required: - id - created_at - account - role properties: account: $ref: '#/components/schemas/WorkspaceAccount' description: The account it belongs to, which is how a dashboard groups the list. created_at: type: string format: date-time description: When it was created; the walk's sort key. id: type: string description: The workspace's identifier. name: type: - string - 'null' description: |- Its name — `null` on rows older than naming, emitted either way for the tenant module's null rule. role: type: string description: 'The caller''s role in that account: `owner` or `member`.' WorkspaceAccount: type: object description: The account a listed workspace belongs to. required: - tenant_id - owner_name properties: owner_name: type: string description: |- What a person calls the account: its owner's display name, or the account's own name when the owner has none. tenant_id: type: string description: The account's tenant. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Send a dashboard session token, an account API key (`agt_t`), or a command-line credential (`afc_`) as a Bearer token. Each endpoint lists accepted credential types. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.