A company: its projects, its people, its invitations
const url = 'https://beta-api.plune.ai/v1/companies/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://beta-api.plune.ai/v1/companies/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>'Every project of the company by name, with the caller’s own standing in each (joined, and the role when joined) — nothing else about a project they are not in; every member with their company role; and, for its owners and admins, the invitations nobody has signed in on yet. A company you are not in, and one in the bin, answer the 404 an id nobody has gets.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Responses
Section titled “ Responses ”The company
The company page. invitations is its owners’ and admins’ business — empty for a member and a reader.
object
What a member of a company may do (ADR 0038). owner and admin manage its people and add them to its projects — only an owner makes, unmakes or removes an owner, and only an owner deletes it; member and reader join its projects themselves. A company role opens no project: joining one gives the project role it maps to — owner and admin → owner, member → member, reader → reader.
A project of the company as any member sees it: its name, and the caller’s own standing in it — role only when joined. Nothing else about a project the caller is not in.
object
What a member may do (B8-team). owner runs the project — members, roles, its name; member does everything else; reader is refused every write at the boundary, before a handler runs.
object
The display name (T3) — absent until the person has given one.
What a member of a company may do (ADR 0038). owner and admin manage its people and add them to its projects — only an owner makes, unmakes or removes an owner, and only an owner deletes it; member and reader join its projects themselves. A company role opens no project: joining one gives the project role it maps to — owner and admin → owner, member → member, reader → reader.
Who brought them in (a userId) — absent for the person who made the company.
An address asked into the company that has not signed in since. projectId is present when it was asked into a company project through POST /v1/members: the sign-in makes it a member of the company AND of that project.
object
What a member of a company may do (ADR 0038). owner and admin manage its people and add them to its projects — only an owner makes, unmakes or removes an owner, and only an owner deletes it; member and reader join its projects themselves. A company role opens no project: joining one gives the project role it maps to — owner and admin → owner, member → member, reader → reader.
Example
{ "id": "6f1c2b3a-0000-4000-8000-0000000000a5", "name": "Acme", "role": "owner", "createdAt": "2026-09-16T09:12:04.151Z", "projects": [ { "id": "9c4e7d10-0000-4000-8000-0000000000a4", "name": "Mobile app", "joined": true, "role": "owner" }, { "id": "9c4e7d10-0000-4000-8000-0000000000a5", "name": "Payments", "joined": false } ], "members": [ { "userId": "u-shop", "name": "Olena Kovalenko", "role": "owner", "createdAt": "2026-09-16T09:12:04.151Z" }, { "userId": "6f1c2b3a-0000-4000-8000-0000000000a2", "role": "admin", "invitedBy": "u-shop", "createdAt": "2026-09-16T09:12:04.151Z" } ], "invitations": [ { "id": "6f1c2b3a-0000-4000-8000-0000000000a6", "role": "member", "createdAt": "2026-09-16T09:12:04.151Z" } ]}No / invalid token or session
No such company among yours
object
Example
{ "error": "company '6f1c2b3a-0000-4000-8000-0000000000a5' not found"}