> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.
# List collaborators
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns the people who can edit the app in Base44, owner first, then everyone else by email. Invite more with [Invite app users](/api-reference/invite-app-users) and `collaborator_role` set to `editor`. The list isn't paginated.
Guests in the app's workspace can't list collaborators. Base44 staff who can edit the app are left out, unless they own it or are a guest in its workspace.
This is limited to 60 requests per minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. List collaborators and Remove collaborator share it. Some workspaces have a different limit.
This endpoint accepts a personal API key belonging to a user with editor access to the app, including a read-only key. Workspace API keys are not accepted.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/users/collaborators
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/apps/{app_id}/users/collaborators:
get:
summary: List collaborators
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns the people who can edit the app in Base44, owner first, then
everyone else by email. Invite more with [Invite app
users](/api-reference/invite-app-users) and `collaborator_role` set to
`editor`. The list isn't paginated.
Guests in the app's workspace can't list collaborators. Base44 staff who
can edit the app are left out, unless they own it or are a guest in its
workspace.
This is limited to 60 requests per minute per app for each workspace's
personal API keys, so every key in a workspace shares one allowance.
List collaborators and Remove collaborator share it. Some workspaces
have a different limit.
This endpoint accepts a personal API key belonging to a user with
editor access to the app, including a read-only key. Workspace API keys
are not accepted.
operationId: list_collaborators_api_apps__app_id__users_collaborators_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app whose collaborators to list.
title: App Id
description: ID of the app whose collaborators to list.
example: 6820f3a4e7b91d003c45a1f2
responses:
'200':
description: The app's collaborators, owner first.
content:
application/json:
schema:
$ref: '#/components/schemas/Collaborators'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have editor access to this app, you're a guest in the
app's workspace, the app is blocked, or you used a workspace API
key.
'404':
description: App not found.
'429':
description: >-
Rate limit exceeded. The base limit is 60 requests per minute. See
[Rate
limits](/developers/references/apps-api/get-started/rate-limits) for
the multiplier your plan gets.
components:
schemas:
Collaborators:
items:
$ref: '#/components/schemas/CollaboratorResponse'
type: array
title: Collaborators
description: The app's collaborators.
CollaboratorResponse:
properties:
id:
type: string
title: Id
description: >-
ID of the collaborator. Pass it to [Remove
collaborator](/api-reference/remove-collaborator). The owner's entry
can have the ID `owner`, which isn't a real ID.
example: 68b2d4f6a8c0e2f4a6b8c0d2
email:
type: string
title: Email
description: Email of the collaborator.
example: jane@acme.com
full_name:
anyOf:
- type: string
- type: 'null'
title: Full Name
description: Full name of the collaborator, or `null` if none is set.
example: Jane Doe
profile_image_url:
anyOf:
- type: string
- type: 'null'
title: Profile Image Url
description: >-
URL of the collaborator's Base44 profile image, or `null` if they
don't have one.
example: https://lh3.googleusercontent.com/a/ACg8ocJ2x
profile_slug:
anyOf:
- type: string
- type: 'null'
title: Profile Slug
description: >-
Slug of the collaborator's public Base44 builder profile, or `null`
if they don't have one.
example: jane-doe
is_owner:
type: boolean
title: Is Owner
description: Whether the collaborator owns the app.
default: false
example: false
is_pending:
type: boolean
title: Is Pending
description: >-
Whether the collaborator was invited but hasn't opened the app in
Base44 yet.
default: false
example: false
is_guest:
type: boolean
title: Is Guest
description: >-
Whether the collaborator is a guest in the app's workspace rather
than a member.
default: false
example: false
collaborator_source:
anyOf:
- type: string
const: workspace
- type: 'null'
title: Collaborator Source
description: >-
`workspace` when the collaborator joined because the app is open to
everyone in its workspace, or `null` when they were invited.
example: workspace
type: object
required:
- id
- email
title: CollaboratorResponse
description: A person who can edit the app in Base44.
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.