> ## Documentation Index > Fetch the complete documentation index at: https://docs.ergoly.ai/llms.txt > Use this file to discover all available pages before exploring further. # List chart placements > Every place on your Company chart a Worker may sit under — a person's seat, a Worker's, a team, an open role — in the order the chart draws them, each with its title and the place it sits under. Pass one's `id` as `reportsTo.placementId` when you create a Worker. Nothing inside a vendor or a client is listed, because a Worker may not sit there. The whole chart comes back at once; it is not paged. ## OpenAPI ````yaml /openapi.json get /api/v1/company/placements openapi: 3.1.0 info: title: Ergoly platform API version: 1.0.0 description: >- Read and change one organization's own Ergoly environment. Every route is scoped to the organization the presented credential resolves to; there is no parameter that widens it. The human-readable reference is served from the same namespace at `/api/v1/docs`, behind the same credential. The namespace's front door is `GET /api/v1`, and it is deliberately absent from `paths` below. It answers without a credential — what this API is, how an organization admin mints a key, and where the reference lives — so it is the way in to this contract rather than a part of it: it has no scope, takes no parameters, and there is nothing about it for a generated client to call. Every `unauthorized` refusal carries that same URL as `error.docs`. servers: - url: https://control.ergoly.ai security: - orgApiKey: [] tags: - name: auth description: How to present a key, what it is scoped to, and what a 401 means. - name: organization description: Which organization your credential resolves to. - name: workers description: The Slack apps and bot identities in your organization. - name: eworks description: The runtime instances under a Worker — one core, one per bound Client. - name: clients description: The customers a Worker can be scoped to, and how to bind one. - name: channels description: Which Slack rooms a Worker answers in, and who it answers as. - name: tasks description: >- Tasks handed between Workers and people, scheduled jobs, their targets, and their run history. - name: jobs description: How a provisioning run is going — the other half of every 202. - name: memory description: Read and write the memory tiers an ework mounts. - name: connections description: The credentials your agents use, and the hosts they are injected on. - name: webhooks description: Inbound URLs an outside system can POST to, each of which starts a turn. - name: activity description: Your organization's audit feed. - name: usage description: Cost, turn outcomes and a per-day pulse over a window you choose. - name: errors description: The closed set of refusal codes, and what to do about each. paths: /api/v1/company/placements: get: tags: - workers summary: List chart placements description: >- Every place on your Company chart a Worker may sit under — a person's seat, a Worker's, a team, an open role — in the order the chart draws them, each with its title and the place it sits under. Pass one's `id` as `reportsTo.placementId` when you create a Worker. Nothing inside a vendor or a client is listed, because a Worker may not sit there. The whole chart comes back at once; it is not paged. operationId: listCompanyPlacements responses: '200': description: Success. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/CompanyPlacement' description: The page. page: $ref: '#/components/schemas/PageInfo' required: - data - page additionalProperties: false example: data: - id: b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e kind: person label: Jordan Lee title: Head of Support parentId: null workerId: null slackUserId: U0A1B2C3D4E page: limit: 50 hasMore: true nextCursor: null '401': description: '`unauthorized`' content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: '`rate_limited`' content: application/json: schema: $ref: '#/components/schemas/Error' security: - orgApiKey: - company:read components: schemas: CompanyPlacement: type: object description: One place on the Company chart a Worker may sit under. properties: id: type: string description: >- The placement id. What `createWorker` takes as `reportsTo.placementId`. kind: type: string enum: - person - worker - team - role description: 'What sits there: a person, a Worker, a team, or an open role.' label: type: string description: >- The name the chart draws: the person's or Worker's name, the team's, or the open role's title. title: type: - string - 'null' description: >- A person's or Worker's title, `Open role` for an open role, null for a team. parentId: type: - string - 'null' description: The placement it sits under. Null at the top level of the chart. workerId: type: - string - 'null' description: >- The Worker in a worker seat — what `GET /api/v1/workers/{id}` takes. Null for every other kind. slackUserId: type: - string - 'null' description: >- The Slack user id of the person in a person seat. Null for every other kind. required: - id - kind - label - title - parentId - workerId - slackUserId additionalProperties: false PageInfo: type: object description: Present on every list, even when there is nothing more to fetch. properties: limit: type: integer description: The page size actually applied, after clamping. hasMore: type: boolean description: True when another page exists. nextCursor: type: - string - 'null' description: >- Feed back as `?cursor=`. Null when `hasMore` is false — and always null on a list that takes no `cursor` parameter, which ranks its rows rather than paging them and says so on its own page. Narrow that list's `query` instead. required: - limit - hasMore - nextCursor additionalProperties: false Error: type: object description: The one error shape. Every refusal in this namespace has it. properties: error: type: object description: The refusal. properties: code: type: string enum: - unauthorized - not_found - invalid_request - conflict - quota_exceeded - rate_limited - upstream_error - gone description: The machine-stable half. Branch on this, never on `message`. message: type: string description: Prose for a human reading a terminal. docs: type: string description: >- Where to learn how to authenticate. Present on `unauthorized` and on nothing else — it is the one refusal a caller can reach with no credential at all, so it is the one that has to say where the way in is. required: - code - message additionalProperties: false required: - error additionalProperties: false securitySchemes: orgApiKey: type: http scheme: bearer description: >- An organization-scoped API key, minted in control under Settings → API keys. Every failure to authenticate answers one identical 401: "Provide a valid organization-scoped API key or an active session." Each operation names the one scope it is filed under, `:`, where the resource is the first path segment after `/api/v1/`; a key minted today carries all 22 of them. Scopes are RECORDED — on the key and on every audit row — and are not yet enforced: no request is refused for want of one. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.