colaboradores de Copilot Spaces
Use la API REST para administrar colaboradores para Copilot Spaces.
List collaborators for an organization Copilot Space
Lists all collaborators for a specific Copilot Space owned by an organization. The authenticated user must have appropriate permissions to view collaborators.
Each collaborator entry specifies which user or team has access to the space and at what level (reader, writer, or admin). The space owner (organization) is excluded from this list.
Note: Team collaborators listed here are teams that are defined in the organization.
OAuth app tokens and personal access tokens (classic) need the read:org scope to use this endpoint.
fine_grained_access
works_with_fine_grained_tokens:
permission_set:
- "GitHub Copilot Business" organization permissions (read)
Parámetros para "List collaborators for an organization Copilot Space"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
org string ObligatorioThe organization name. The name is not case sensitive. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
http_status_code
| status_code | Descripción |
|---|---|
200 | OK |
403 | Forbidden |
404 | Resource not found |
code_samples
data_residency_notice
request_example
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/orgs/ORG/copilot-spaces/SPACE_NUMBER/collaboratorsResponse
Status: 200{
"collaborators": [
{
"actor_type": "User",
"role": "writer",
"login": "octocat",
"id": 12345,
"node_id": "MDQ6VXNlcjEyMzQ1",
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"gravatar_id": "",
"url": "https://api.github.com/users/octocat",
"html_url": "https://github.com/octocat",
"followers_url": "https://api.github.com/users/octocat/followers",
"following_url": "https://api.github.com/users/octocat/following{/other_user}",
"gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"repos_url": "https://api.github.com/users/octocat/repos",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false,
"name": "The Octocat",
"company": "GitHub",
"blog": "https://github.com/blog",
"location": "San Francisco",
"email": "octocat@github.com",
"hireable": false,
"bio": "There once was...",
"twitter_username": "octocat",
"public_repos": 2,
"public_gists": 1,
"followers": 20,
"following": 0,
"created_at": "2008-01-14T04:33:35Z",
"updated_at": "2008-01-14T04:33:35Z"
},
{
"actor_type": "Team",
"role": "reader",
"id": 67890,
"node_id": "MDQ6VGVhbTY3ODkw",
"url": "https://api.github.com/teams/67890",
"html_url": "https://github.com/orgs/octo-org/teams/developers",
"name": "Developers",
"slug": "developers",
"description": "Team of developers",
"privacy": "closed",
"notification_setting": "notifications_enabled",
"members_url": "https://api.github.com/teams/67890/members{/member}",
"repositories_url": "https://api.github.com/teams/67890/repos",
"parent": null,
"created_at": "2017-07-14T16:53:42Z",
"updated_at": "2017-08-17T12:37:15Z",
"organization": {
"login": "octo-org",
"id": 1,
"node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
"url": "https://api.github.com/orgs/octo-org",
"repos_url": "https://api.github.com/orgs/octo-org/repos",
"events_url": "https://api.github.com/orgs/octo-org/events",
"hooks_url": "https://api.github.com/orgs/octo-org/hooks",
"issues_url": "https://api.github.com/orgs/octo-org/issues",
"members_url": "https://api.github.com/orgs/octo-org/members{/member}",
"public_members_url": "https://api.github.com/orgs/octo-org/public_members{/member}",
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"description": "A great organization"
}
}
]
}Add a collaborator to an organization Copilot Space
Adds a collaborator (user or team) to a specific Copilot Space owned by an organization. The authenticated user must have appropriate permissions to manage collaborators.
Note: When adding users as collaborators, they must already be members of the organization. When adding teams as collaborators, they must be defined in the organization.
OAuth app tokens and personal access tokens (classic) need the write:org scope to use this endpoint.
fine_grained_access
works_with_fine_grained_tokens:
permission_set:
- "GitHub Copilot Business" organization permissions (write)
Parámetros para "Add a collaborator to an organization Copilot Space"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
org string ObligatorioThe organization name. The name is not case sensitive. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
| Nombre, Tipo, Descripción |
|---|
actor_type string ObligatorioThe type of actor (user or team). Puede ser uno de los siguientes: |
actor_identifier string ObligatorioThe username (for users) or team slug (for teams). The numeric ID of a user or team is also accepted. |
role string ObligatorioThe role to grant to the collaborator. Puede ser uno de los siguientes: |
http_status_code
| status_code | Descripción |
|---|---|
201 | Created |
403 | Forbidden |
404 | Resource not found |
422 | Validation failed, or the endpoint has been spammed. |
code_samples
data_residency_notice
request_examples
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/orgs/ORG/copilot-spaces/SPACE_NUMBER/collaborators \
-d '{"actor_type":"User","actor_identifier":"octocat","role":"writer"}'Response
Status: 201{
"actor_type": "User",
"role": "writer",
"login": "octocat",
"id": 12345,
"node_id": "MDQ6VXNlcjEyMzQ1",
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"gravatar_id": "",
"url": "https://api.github.com/users/octocat",
"html_url": "https://github.com/octocat",
"followers_url": "https://api.github.com/users/octocat/followers",
"following_url": "https://api.github.com/users/octocat/following{/other_user}",
"gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"repos_url": "https://api.github.com/users/octocat/repos",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false,
"name": "The Octocat",
"company": "GitHub",
"blog": "https://github.com/blog",
"location": "San Francisco",
"email": "octocat@github.com",
"hireable": false,
"bio": "There once was...",
"twitter_username": "octocat",
"public_repos": 2,
"public_gists": 1,
"followers": 20,
"following": 0,
"created_at": "2008-01-14T04:33:35Z",
"updated_at": "2008-01-14T04:33:35Z"
}Set a collaborator role for an organization Copilot Space
Updates the role of a collaborator for a specific Copilot Space owned by an organization. The authenticated user must have appropriate permissions to manage collaborators.
OAuth app tokens and personal access tokens (classic) need the write:org scope to use this endpoint.
fine_grained_access
works_with_fine_grained_tokens:
permission_set:
- "GitHub Copilot Business" organization permissions (write)
Parámetros para "Set a collaborator role for an organization Copilot Space"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
org string ObligatorioThe organization name. The name is not case sensitive. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
actor_type string ObligatorioThe type of actor (user or team). Puede ser uno de los siguientes: |
actor_identifier string ObligatorioThe username (for users) or team slug (for teams). The numeric ID of a user or team is also accepted. |
| Nombre, Tipo, Descripción |
|---|
role string ObligatorioThe new role to grant to the collaborator. Use Puede ser uno de los siguientes: |
http_status_code
| status_code | Descripción |
|---|---|
200 | OK |
204 | Response when |
403 | Forbidden |
404 | Resource not found |
422 | Validation failed, or the endpoint has been spammed. |
code_samples
data_residency_notice
request_examples
curl -L \
-X PUT \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/orgs/ORG/copilot-spaces/SPACE_NUMBER/collaborators/ACTOR_TYPE/ACTOR_IDENTIFIER \
-d '{"role":"admin"}'Response
Status: 200{
"actor_type": "User",
"role": "admin",
"login": "octocat",
"id": 12345,
"node_id": "MDQ6VXNlcjEyMzQ1",
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"gravatar_id": "",
"url": "https://api.github.com/users/octocat",
"html_url": "https://github.com/octocat",
"followers_url": "https://api.github.com/users/octocat/followers",
"following_url": "https://api.github.com/users/octocat/following{/other_user}",
"gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"repos_url": "https://api.github.com/users/octocat/repos",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false,
"name": "The Octocat",
"company": "GitHub",
"blog": "https://github.com/blog",
"location": "San Francisco",
"email": "octocat@github.com",
"hireable": false,
"bio": "There once was...",
"twitter_username": "octocat",
"public_repos": 2,
"public_gists": 1,
"followers": 20,
"following": 0,
"created_at": "2008-01-14T04:33:35Z",
"updated_at": "2008-01-14T04:33:35Z"
}Remove a collaborator from an organization Copilot Space
Removes a collaborator from a specific Copilot Space owned by an organization. The authenticated user must have appropriate permissions to manage collaborators.
OAuth app tokens and personal access tokens (classic) need the write:org scope to use this endpoint.
fine_grained_access
works_with_fine_grained_tokens:
permission_set:
- "GitHub Copilot Business" organization permissions (write)
Parámetros para "Remove a collaborator from an organization Copilot Space"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
org string ObligatorioThe organization name. The name is not case sensitive. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
actor_type string ObligatorioThe type of actor (user or team). Puede ser uno de los siguientes: |
actor_identifier string ObligatorioThe username (for users) or team slug (for teams). The numeric ID of a user or team is also accepted. |
http_status_code
| status_code | Descripción |
|---|---|
204 | No Content |
403 | Forbidden |
404 | Resource not found |
code_samples
data_residency_notice
request_example
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/orgs/ORG/copilot-spaces/SPACE_NUMBER/collaborators/ACTOR_TYPE/ACTOR_IDENTIFIERResponse
Status: 204List collaborators for a Copilot Space for a user
Lists all collaborators for a specific Copilot Space owned by a user. The authenticated user must be the owner of the space or have admin access to the space.
Each collaborator entry specifies which user has access to the space and at what level (reader, writer, or admin). The space owner is excluded from this list.
Team collaborators are not supported for user-owned Copilot Spaces.
OAuth app tokens and personal access tokens (classic) need the user scope to use this endpoint.
fine_grained_access
no_fine_grained_access
Parámetros para "List collaborators for a Copilot Space for a user"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
username string ObligatorioThe handle for the GitHub user account. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
http_status_code
| status_code | Descripción |
|---|---|
200 | OK |
403 | Forbidden |
404 | Resource not found |
code_samples
data_residency_notice
request_example
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/users/USERNAME/copilot-spaces/SPACE_NUMBER/collaboratorsResponse
Status: 200{
"collaborators": [
{
"actor_type": "User",
"role": "writer",
"login": "octocat",
"id": 12345,
"node_id": "MDQ6VXNlcjEyMzQ1",
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"gravatar_id": "",
"url": "https://api.github.com/users/octocat",
"html_url": "https://github.com/octocat",
"followers_url": "https://api.github.com/users/octocat/followers",
"following_url": "https://api.github.com/users/octocat/following{/other_user}",
"gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"repos_url": "https://api.github.com/users/octocat/repos",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false,
"name": "The Octocat",
"company": "GitHub",
"blog": "https://github.com/blog",
"location": "San Francisco",
"email": "octocat@github.com",
"hireable": false,
"bio": "There once was...",
"twitter_username": "octocat",
"public_repos": 2,
"public_gists": 1,
"followers": 20,
"following": 0,
"created_at": "2008-01-14T04:33:35Z",
"updated_at": "2008-01-14T04:33:35Z"
},
{
"actor_type": "User",
"role": "reader",
"login": "github-user",
"id": 67890,
"node_id": "MDQ6VXNlcjY3ODkw",
"avatar_url": "https://github.com/images/error/other_user.gif",
"gravatar_id": "",
"url": "https://api.github.com/users/github-user",
"html_url": "https://github.com/github-user",
"followers_url": "https://api.github.com/users/github-user/followers",
"following_url": "https://api.github.com/users/github-user/following{/other_user}",
"gists_url": "https://api.github.com/users/github-user/gists{/gist_id}",
"starred_url": "https://api.github.com/users/github-user/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/github-user/subscriptions",
"organizations_url": "https://api.github.com/users/github-user/orgs",
"repos_url": "https://api.github.com/users/github-user/repos",
"events_url": "https://api.github.com/users/github-user/events{/privacy}",
"received_events_url": "https://api.github.com/users/github-user/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false,
"name": "GitHub User",
"company": null,
"blog": "",
"location": null,
"email": null,
"hireable": null,
"bio": null,
"twitter_username": null,
"public_repos": 5,
"public_gists": 0,
"followers": 10,
"following": 5,
"created_at": "2010-01-14T04:33:35Z",
"updated_at": "2010-01-14T04:33:35Z"
}
]
}Add a collaborator to a Copilot Space for a user
Adds a collaborator to a specific Copilot Space owned by a user. The authenticated user must be the owner of the space or have admin access to the space.
Team collaborators are not supported for user-owned Copilot Spaces.
OAuth app tokens and personal access tokens (classic) need the user scope to use this endpoint.
fine_grained_access
no_fine_grained_access
Parámetros para "Add a collaborator to a Copilot Space for a user"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
username string ObligatorioThe handle for the GitHub user account. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
| Nombre, Tipo, Descripción |
|---|
actor_type string ObligatorioThe type of actor (must be Puede ser uno de los siguientes: |
actor_identifier string ObligatorioThe username of the collaborator. The numeric user ID is also accepted. |
role string ObligatorioThe role to grant to the collaborator. Puede ser uno de los siguientes: |
http_status_code
| status_code | Descripción |
|---|---|
201 | Created |
403 | Forbidden |
404 | Resource not found |
422 | Validation failed, or the endpoint has been spammed. |
code_samples
data_residency_notice
request_example
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/users/USERNAME/copilot-spaces/SPACE_NUMBER/collaborators \
-d '{"actor_type":"User","actor_identifier":"octocat","role":"writer"}'Response
Status: 201{
"actor_type": "User",
"role": "writer",
"login": "octocat",
"id": 12345,
"node_id": "MDQ6VXNlcjEyMzQ1",
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"gravatar_id": "",
"url": "https://api.github.com/users/octocat",
"html_url": "https://github.com/octocat",
"followers_url": "https://api.github.com/users/octocat/followers",
"following_url": "https://api.github.com/users/octocat/following{/other_user}",
"gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"repos_url": "https://api.github.com/users/octocat/repos",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false,
"name": "The Octocat",
"company": "GitHub",
"blog": "https://github.com/blog",
"location": "San Francisco",
"email": "octocat@github.com",
"hireable": false,
"bio": "There once was...",
"twitter_username": "octocat",
"public_repos": 2,
"public_gists": 1,
"followers": 20,
"following": 0,
"created_at": "2008-01-14T04:33:35Z",
"updated_at": "2008-01-14T04:33:35Z"
}Set a collaborator role for a Copilot Space for a user
Updates the role of a collaborator for a specific Copilot Space owned by a user. The authenticated user must be the owner of the space or have admin access to the space.
OAuth app tokens and personal access tokens (classic) need the user scope to use this endpoint.
fine_grained_access
no_fine_grained_access
Parámetros para "Set a collaborator role for a Copilot Space for a user"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
username string ObligatorioThe handle for the GitHub user account. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
actor_type string ObligatorioThe type of actor (must be Puede ser uno de los siguientes: |
actor_identifier string ObligatorioThe username of the collaborator. The numeric user ID is also accepted. |
| Nombre, Tipo, Descripción |
|---|
role string ObligatorioThe new role to grant to the collaborator. Use Puede ser uno de los siguientes: |
http_status_code
| status_code | Descripción |
|---|---|
200 | OK |
204 | Response when |
403 | Forbidden |
404 | Resource not found |
422 | Validation failed, or the endpoint has been spammed. |
code_samples
data_residency_notice
request_example
curl -L \
-X PUT \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/users/USERNAME/copilot-spaces/SPACE_NUMBER/collaborators/ACTOR_TYPE/ACTOR_IDENTIFIER \
-d '{"role":"admin"}'Response
Status: 200{
"actor_type": "User",
"role": "admin",
"login": "octocat",
"id": 12345,
"node_id": "MDQ6VXNlcjEyMzQ1",
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"gravatar_id": "",
"url": "https://api.github.com/users/octocat",
"html_url": "https://github.com/octocat",
"followers_url": "https://api.github.com/users/octocat/followers",
"following_url": "https://api.github.com/users/octocat/following{/other_user}",
"gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"repos_url": "https://api.github.com/users/octocat/repos",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false,
"name": "The Octocat",
"company": "GitHub",
"blog": "https://github.com/blog",
"location": "San Francisco",
"email": "octocat@github.com",
"hireable": false,
"bio": "There once was...",
"twitter_username": "octocat",
"public_repos": 2,
"public_gists": 1,
"followers": 20,
"following": 0,
"created_at": "2008-01-14T04:33:35Z",
"updated_at": "2008-01-14T04:33:35Z"
}Remove a collaborator from a Copilot Space for a user
Removes a collaborator from a specific Copilot Space owned by a user. The authenticated user must be the owner of the space or have admin access to the space.
OAuth app tokens and personal access tokens (classic) need the user scope to use this endpoint.
fine_grained_access
no_fine_grained_access
Parámetros para "Remove a collaborator from a Copilot Space for a user"
| Nombre, Tipo, Descripción |
|---|
accept string Setting to |
| Nombre, Tipo, Descripción |
|---|
username string ObligatorioThe handle for the GitHub user account. |
space_number integer ObligatorioThe unique identifier of the Copilot Space. |
actor_type string ObligatorioThe type of actor (must be Puede ser uno de los siguientes: |
actor_identifier string ObligatorioThe username of the collaborator. The numeric user ID is also accepted. |
http_status_code
| status_code | Descripción |
|---|---|
204 | No Content |
403 | Forbidden |
404 | Resource not found |
code_samples
data_residency_notice
request_example
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/users/USERNAME/copilot-spaces/SPACE_NUMBER/collaborators/ACTOR_TYPE/ACTOR_IDENTIFIERResponse
Status: 204